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This summary is Intended for the experienced author who needs a quick 
reference for the form of a tag and for some of the restrictions on commands. 
It does not discuss fine details of the TUTOR language. For such information 
authors should refer to "aids" and to The TUTOR Language by Bruce Sherwood. 

Each command includes a brief description of its purpose and a descrip- 
tion of the tag. The standard form is 

command brief description 



or 



NOTE: 



The commands are grouped into nine categories: calculating (C), 
data keeping (d), file operations (F), judging (J), managing sites (M)» 
presenting (P), routing (R), sequencing (S), terminal resident processing (T). 
Commands which are difficult to classify are placed in categories which 
describe their most probable use. 

Modifications to this book required by changes in the TUTOR language are 
contained in lesson "aids" (press DATA and type: changes to summary). These 
modifications, along with other notes of interest, may be inserted in the spaces 
which have been provided between entries and on the additional pages at the end 
of each section. 



command DESCRIPTION OF TAG (any explanatory comments) 
command actual tag 

Note: Additional comments about this command. 
General comments about groups of commands. - 
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Abbreviations and Notes 
Below are listed the abbreviations used In the descriptions. 





fi^f'f n'f t"i nn 


arg 


oLglluicnu UL Lag Cll LL jr 






U Uai. oC 


pV|Q r" a p f PT* OT"f H p nn T'fi'f na t* p*2 


CM 


^ on f- >• Q 1 m O mo T* \7 ' 
CcnU STaX mCmU L j 


v>lr U 


cenurax processing uniu 


disk 


rotating magnetic disk storage unit 


EM 


extended memory (e.g., ECS, AMS, ESM) 


expr 


mathematical expression 


f IneXjf Iney 


fine grid coordinates 


num 


number of 


(opt) 


optional argument 


ppt 


programmable terminal (1ST and PPT) 


string 


character string 


var 


variable 


vars 


variables 



In conditional statements and In statements where a >^arlable Is set, suffixes 
m, 0, 1, 2, etc., denote the minus condition, 0 condition, 1 condition, 
2 condition, etc., e.g., 

match VAR, WORD0, WORD 1 ,W0RD2 

d o EXPR , NAMEM , NAME0 , NAME 1 , NA1'IE2 

In conditional statements the conditional expression is rounded (not truncated) 
to the nearest Integer. Thus, a value of -.4 results in the 0 condition being 
selected rather than the minus condition. 

Generally, wherever a tag entry may be a number, a mathematical expression will 
also be accepted. 

Command names are enclosed in dashes when they are referred to in descriptions, 
e.g., -next-. Names of system variables are enclosed in double quotes, e.g., 
"zreturn". Key names are capitalized, e.go, NEXT. A function key name followed 
by "1", e.g., NEXTl, indicates the SHIFT key is held while the key is pressed. 

A word which is enclosed in single quotes designates information which is stored 
left-justified in a variable, e.g., 'student'. 

Commands labeled "non-executable" are active only when the lesson is being 
condensed and not during execution. 

When variables are used in the tag of certain commands which -require names in 
the tag, e.g., -area-, the variable dust be enclosed in parentheses to indicate 
that the Information needed is the contents of the variable and not a character 
string; e.g., -area (v3)- means the area whose name is contained in variable v3, 
while -area v3- means the area whose name 1st v3. 

Some commands use the text delimiter (^) to separate arguments (e.g., -writec-, 
-packc-, etc.). This symbol is obtained by pressing MICRO and then comma. 
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CALCULATING 



Basic calculating CI 

define 

Ivars 

calc 

calcc 

calcs 

addl 

subl 

zero 

set 



Random numbers C8 

seed 

randu 

setperm 

randp 

remove 

restore 

mod perm 



Information C10 

name 

group 

compute 

clock 

date 

day 

ctlme 

cdate 



Bit and character manlptilatlon C12 

search 

pack 

packc 

move 

Itoa 

otoa 

htoa 

clean 

recname 



Operations on lists Cl5 

sort 

sorts ' 

finds 

flndsa 

Inserts 

deletes 

find 

flndall 



Data manipulation C19 

block 

transfr 

common 

comload 

comret 

abort 

commonx 

in' -lal 

stf -age 

s to load 

reserve 

..^elease 

backgnd 

foregud 



System variables for calculating C23 

1 common 

Istorag 

zbpc 

r.bpw 

zcpw 

zcusers 
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DATA KEEPING 



Requesting data Dl 

dataon < 
dataoff 



Classifying data D2 

area 
output 
outputl 
setdat 



System variables for datakeeplng D6 

collecting date 

dataon 

session data 

zsesset 
zsesspt 
zsessda 

area data 



Transferring data D3 

read set 
readd 



Signing on and off D5 

restart 

finish 

permit 



aarea 
aarrowsv 
ahelp 
ahelpn 
aok 

aoklst 
asno 
aterm 
ai:^rmn 
atlme 
auno 
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FILE OPERATIONS 



Attaching and accessing files Fl 

attach 
"detach 
access 

Datasets and namesets F3 

datain 

dataout 

reserve 

release 

setname 

getname 

addname 

rename 

addrecs 

delrecs 

delname 

names 



Group files F8 

records 
checkpu 



TUTOR files and code files .F15 

setname 

getname 

names 

iospecs 

getline 

setline 

parse 



System variables for file operations 

zcheck 

zf acc 

zfile 

zf tVpe 

zfusers 

zinto 

zline 

zni^ndex 

znscpn 

znsmaxn 

znsmaxr 

znsnams 

znsrecs 

zrecs- 

zrof f 

zrstatn 

zrtype 

zrvars , 

zrvret 

zsvars 

zsvret 

zwpb 

zwpr 

zxf lie 
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JUDGING 



Preparation for 
responding Jl 

eraseu 

force " 

edit * ' 

arrow 

arrova 

arheada 

long 

jkey 

copy 

endarrov 



Vocabulary lists J4 

list 
endings 
vocabs 
vocab 



Modification of judging 
copy of response J5 

bump' 

put 

putd 

putv 

close 

load a 



Modification of judging 
• procedure J6 

specs 



Storing judging copy of 
response J8 

store 

storeu 

storen 

storea 

open 



Matching judging 

copy of response J9 

match 

answer 

wrong 

answerc 

wrongc 

answers 

wronga 

concept 

ml scon 

exact I 

exact c ' 

exactv 

ansv 

wrongv 

ansu 

wrongu 

touch 

touchw 

or 

ans 



Information on specific 
words in response J13 



getword 
getmark 
getlcc 
compare 



Unconditional judgment J15 

ok 
no 

Ignore 



Reference to other units 
which may contain 
judging commands J16 

join 

iarrow 

iarrowa 



Alteration of 
judgment J 17 

judge 



Alteration of 
feedback J 18 



okword 
noword 
markup 
markupy 



System variables, 
for judging J19 

judging in general 

anscnt 

i 

ansok ^ 
j count 
judged 
key 

ntries 
ztouchx 
2 touchy 

verbal responses 

capital 

entire 

extra 

order 

phrase 

spell 

vocab 

wcount 

numerical responses 

opcnt 

varcrt 

formok 
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MANAGING SITES 



Site coramands Ml 

site set 

site info 

site active 

site stations 



System variables for managing sites M6 



zlsac 
2 runner 



Station commands M3 

1 

station info 
station, status 
station send 
stati.on l^out 
station stOpl 
station off 
station on 
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PRESENTING 



Basi<; display -PI Relocatable graphics P8 Non-screen P16 



at 

atnm 
write ^ 
writec 
show 
. showz 
shbwt 
showe 
showo 
showh 
showa 
hidden 
text * 
erase 
mode 
size 
rotate 
delay 
lang 
Inhibit 
char. . 
plot 



^Graphics P6 



dpt 

.draw 

box 

fill; • \ 
vector 
window^ 
circle . 
clrcleb 



rorigin 
" rat / . 

ratnm 

rdot 

rdraw 

rbox 

. rvector 

rc'lrcle 



Drawing graphs P10 

gorlgln 

axes 

bounds 

scalex 

scaley . 
' Iscalex 
.^Iscaley 

labelx 

labely 

markx ^ 

marky 

polar 
'gat 

gatnm 
'gdot 

graph 

gdraw 

gbox 

gclrcle 

gvector 

vbar 

hbar 

delta 

funct 



slide 

audio 

play 

record 

enable 

disable 

ext * 

extout 

xout 

xln 

beep 

say lang 

say 

sayc 



Special display P19 

tabset 

micro 

charset 

chartst 

llneset 

alt£ont 



System variables 
for presenting 

mode 

size 

slzex 

slzey 

where 

wherex 

wherey 

zlang 
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ROUTING 

Router lesson Rl 




allow 



Curriculum information R2 

lesson 

score 

status 



System variables for routing R3 

errtype 

Id one 

Iscore 

Istatus 

rcallow 

router 

rs tartl 

rstartu 

rvallow 

zcurric 

zleserr 
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SEQUENCING 
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Basic sequencing SI 

unit 

unitop 

entry 



Automatic sequencing 82 

jump 
goto 
do 

join 

return 

exit 

if error 

imain 

branch 

doto 

if 

elseif 

el^^e 

eridlf 

lo6p 

end loop 

out loop 

rei^oop 



Key-initiated sequencing S7 

next, nextl 
back, backl 
stop 
next now 

nextop^ next lop 
backop> backlop 
help, helpl 
data, datal 
lab, labl 
helpop> help lop 
dataop^ data lop 
labop, lab lop 
term 
terB^p 
base 
end 
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Timing 89 

keylist 

pause 

collect 

get code 

keytype 

time 

timel V 

timer 

press 

catchup 

break 

cpulim 



Lesson connections 
and sections S12 

use 

jumpout 

args 

from 
^ lessin 
'in 

notes 

cstart 

estop 

estop* 



Lesson lists 815 

leslist 

addlst 

removl 

reserve 

release 

Iname 

findl 



Lesson annotation 
and debugging 817 



c 

$$ 

change 

step 

*list 



System variables 
for sequencing 

args 

backout 

baseu 

clock 

f romnum 

key 

lessnum 

lleslst 

llesson 

mainu 

mallot 

muse 

nhelpop 

proctim 

ptime 

sitenam 

station 

tactive 

user 

users in 

zaccnam 

zbatch 

zcondok 

zfroml 

zfromu 

zgroup 

zid 

zlesson 

zpnf ile 

zpnotes 

zretrnu 

zreturn 

zsnf ile 

zsnotes 

zsvsid 

zsystem 

z^rm 

ztouchx 

ztouchy ' 

ztzone 

zunit 

zusers 
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TERMINAL RESIDENT PROCESSING 



Loadi.n& And running Tl 


Judging T9 


ptutor 


darrow 


unit 


arrow / 


loaau V 


endarrow. 


irunti 


long 




force 




jkey 




copy 
putd 




specs 


key wo rd 




answer 


calcc 


wrong 


calcs 


answer c 


zero 


wrongc 


86 1 


exact 


coonpute 


exactw 


iTandu 


ansv 


05? U ^ C L Ul 


wrongv 


randp 


ok 


remove 




restore 


or 


block 


if match 


rinu 


iarrow 


pack 


ijudge 


oca£ Cn 


judge 


Seal^CQX 


okword 




noword 




getmark 


getloc 








Presenting 






write 




writec 




show 




showt 




showb 




showo 




showh 




showa 




erase 




mode 




size 




rotate 




tabset 




text 




textn 




gfill 
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Presenting (cont.) 

charlim 

charset 

char 

getchar 

inhibit 

allow 

xout 

xin 

intrupt 
at 

atpm 

circle 

circleb 

draw 

dot 

box 

plot 

fill 

vector 

enable 

disable 

play 

record 

slide 

beep 

gorigin 

axes 

bounds 

seal ex 

scaley 

labelx 

labely 

markx 

marky 

gdot / 
gdraw \ j 

gbox \' 
gat 
gatnm 

vbar I 

hbar / 

gvector 

gcircle 

rorigin 

rat 

ratnm 

rdot 

rdraw 

rcircle 
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continued on next page 
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TERMINAL RESIDENT PROCESSING (cont* from previous page) 



Exchanging information 

with central system T20 

xmlt 
receive 
sendkey 
trap 



Routing T22 

lesson 
score 



Sequencing T23 

jumpn 

jumpout 

press 

getkey 

clrkey 

key type 

if 

elseif 

else 

endif 

loop 

reloop 

outloop 

endloop 

cetart 

estop 

estop* 

use 

keylist 

next 

nextl 

back 

backl 

help 

helpl 

data 

datal 

lab 

labl 

stop 

imain 

goto 

do 

jump 

base 

doto 

pause 

branch 



Running assembler 
programs T25 

pptaddr 

pptload 

ppttest 

pptclr 

pptdata 

pptout 

pptrun 

ppthalt 



System variables for 
terminal resident 
processing T28 

zanscnt 

zcomm 

zdata 

zentire 

zextra 

zjcount 
' zjudged 

zkey 

zldone 

zmode 

zntries 

zopcnt 

zorder 

zrecs 

zreturn 

zrouten 

zscore 

zspell 

ztbase 

ztmem 

ztmemr 

ztprog 

ztrap 

zttype 

zwcount 
/ zwherex 

zwherey 
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Basic calculating 



define (non-executable) permits an author to rename variables and to define 
mathematical functions, arrays » and constants for a lesson and to 
specify those available for student use; defined variables must 
physically precede any reference to the variables In the lesson 

for example: 

define DEFNAME 

NAMEl"vl,NAME2-n2,NAME3"65;>JAME4-2(NAMEl+NAM23) , . . . 
\^ FUNC(x,y,...)"8ome function of x, y, etc., where x, y, etc. 

are not already defined, although the expression oh the right 
of the equal sign may contain previously defined names 
(up to 6 arguments are permitted) 

\ 

Th^ following definitions allow use of segmented variables. 

segment, NAME-STARTING VAR,NUM BITS PER BYTE, signed (opt) or 
V segment, NAME-STARTING VAR,NUM BITS PER BYTE,s (opt) 
segmentv, NAME-STARTING VAR, STARTING BIT POSITION, 
NUM BITS PER BYTE,s (opt) 
(Starting variable address and byte size cannot be 
variables. Byte size Is from I to 59. If the last ^ 
argument ("signed" or "s") Is Included, negative as well as 
positive Integers may be stored. In vertical segment, 
starting bit position may be from I to 60.) 

The following definition sets up a field of less than 60 bits. 

segmentf,NAME-VAR, STARTING BIT POSITION, NUM BITS,s (opt) 
(Restrictions are those for segmented variables* 
Field variables are not Indexed.) 

* i 

The following definitions allow use of arrays. 

^ array, NAME(SIZE)-STARTING VAR (SIZE gives number of 

variables required) 
array, NAME(NUM ROWS, NUM COLUMNS) -STARTING VAR 
(number of variables equals rows x columns) 
array, NAME(FIRST ELEMENT;LAST«ELEMENT)-STXrTING VAR 
array, NAME(FIRST ROW ELEMENT, FIRST COLUMN ELEMENT;LAST 
ROW ELEMENT, LAST COLUMN ELEMENT)-STARTING VAR 

Arrays may also be defined with segmented variables. The form Is 
thst for vertical segments. For example: 

arraysegv,NAME(SIZE)«STARTING VAR, STARTING BIT POSITION, 
NUM BITS PER BYTE,s (opt) 

Up to 255 elements are permitted in an array. 

. n - 

(-define- continued on next page.) 



\ 



define student^ 

all defines necessary for student responses, Including units 

! 

unlts,UNlTI,UNIT2,«« • (maximum of 10 units, such as gram, 

meter,, second,. . .) 
(The define set "student** may also Include abbreviations 
and equivalences involving these units. See -storeu-, 
-ansu-, a^nd -wrongu- for these applications.) 

To merge a previous set of definitions (SKTA) with a set being 
defined at this point in the program (SETB): 

define SETB, SETA 

definitions in SETB 

To purge previous define sets: \ 

define purge, DEFNAME (discards define set named) 

define purge (discards all define setp except ''student**) 

Note: Approximately 1500 definitions are permitted in active define 
sets, fewer if definitions are complicated. (Define set , 
**student** may contain approximately 500 definitions.) Defined 
names and names of define sets cannot exceed 7 characters, 
cannot contain mathematical operators, and must start with a 
letter. Up to 5 define sets may be referenced. When a 6th set 
is activated, all earlier sets except **student** are discarded,.^ 

A local define set may be declared as a continuation of a -unit- 
command. (The -define- command is omitted.) Features described 
above are available. In addition, local variables may be declared. 
Sample formats for local variables are: 

unit someu 

NAME1,NAME2,NAME3(SIZE) 
NAME4-C0NSTANT 

floatlng:NAME5,NAME6,NAME7CSIZE) ^ 
integer, NUM BITS: NAMES, NAME9 
integer, NUM BITS ,slgned:NAMEl0 \ 
lnteger:NAMElI .\ 

To merge the local define set with the **gldba; 

unit someu 

mergefDEFNAME (merges with the define set named) 

or 

\ 

unit someu 

merge, previous (merges with the previous define set) 



define set: 
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C3 



Ivars (non-executable) sets up a buffer in memory for local variables for 
the lesson; required if the lesson uses local variables; must appear 
in the ieu before any references to a unit 

Ivars SIZE OF BUFFER (maximum size of 128) 



calc assigns the valve of the expression on the right side of the assign 
arrow to the variable or array on the left side, or packs up to 10 
characters into an integer variable 

for example :> 

calc VAR« EXPR 

calc VAR* "STRING" (right-justified, use n-variable) 

calc VAR4- 'STRING' (left- justified, use n-variable) 
, calc ARRAYNAME4 EXPR (in9ludes standard arithmetic operations, 
bit operations, and logical operations on entire arrays 
and on array elements, and array functions operating on^ 
entire arrays) _ - • 

calc VAR« ARRAYNAMEI <> ARRAYNAME2^ — " '"^ 

calc ARRAYNAMEI* ARRAYNAMEa-X-^ARRAYNAMES 

-Note: See section on SEQUENCING, Automatic sequencing for ^doto*, 
-branch-, -if-, -loop-, and related directives* These are 
dale-type commands which allow branching within a unit* 



calcc does one of several calculations depending on the rounded value 
of a conditional expression 

calcc EXPR,VARI« EXPRM, VAR24 EXPR0, VAR3« EXPRI , ,VAR4« EXPR3 



calcs sets a variable to one of several values depending on the rounded 
value of a conditional expression 

calcs EXPR, VAR<^ EXPRM, EXPR0, EXPRI ,EXPR2 , ,EXPR4 

NOTE: Up to 61 calculations may be performed with -calcc- or -calcs- • 
A blank tag entry (,,) means no calculation is done for the 
corresponding value of the conditional expression. 

add I adds I to the specified variable; can be used with array elements 
but not with entire arrays 

add I VAR 




subtracts 1 from the specified variable; can be used with array 
elements but not with entire arrays 

subl VAR 



sets to zero a single variable or a set of consecutive variables; 
can be used with array el/uments but not with entire arrays 

zero VAR ' / 

zero STARTING VAR^JfUM^VARS (cannot be used with segmented 
y\j[ variables or segmented arrays) 

sets values of consecutive variables starting at the specified 
variable, or sets values of matrix elements starting at the 
specified element (starts at the first element if no element is 
specified); can bemused to set segmented arrays but not segmented 
variables « 



set 
set 
set 



STARTING VAR^ VALUEl , VALUE2 , VALUE3 , . . 
ARRAYNAME^ VALUEl , VALUE2 , VALUES , . . . 
ARRAYNAME(ROW; COLUMN)^ VALUEl, VALUE2 ,VALUE3 , 



• • • 



Note: Up to 61 values may be set with a single -set- command. 
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Operations and symbols used in calculations 



addition 



+ 



subtraction 

multiplication x or * (implied multiplicacion is permitted, e.g., 5a) 



cross product of two arrays X 
parentheses, brackets ()>[]>(} 

exponentiation ** or superscript or shift-superscript (e.g., a^) 
assignment of a value to a variable ^ 
IT - pi - 3.14159... 

° « degree sign; indicates a number is interpreted in degrees, e.g., 30**; 
number x 1° converts number to radians; 
number 1° converts number to degrees 

Address of a variable may be an expression; i.e.; v(EXPR) is permitted, 
whmve EXPR is rounded to the nearest integer. 

Precedence of operations (in brief) 
operations within parentheses 
exponentiation 
omltiplication 
division 

addition and subtraction 



In general with anything but very simple expressions, parentheses should 
be used freely. 

NOTE: The computer has approximately 14-digit accuracy. 

Values of floating-point numbers range from about i:10"'293 i:l0+322. 
Values of integers range from about -1017 to +1017. 
However, multiplication and division of large integer values may give 
erroneous results because of limitations on integer arithmetic. 



• division 



i or / 



dot product of two arrays 



o 
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System functions (argument may be an expression) 



abs(X) 
arctan(X) 

C08(X) 

exp(X) 

frac(X) 
int(X) 

log(X) 

ln(X) 

rouncKX) 

sign(X) 

sin(X) 

sqrt(X) 

varloc(X) 

zfinex(X) 
zflney(X) 



absolute value of X 

inverse tangent, result in radians, range -ii/2 to +ii/2 ; 
for result in degrees, use arctan(X)/l° 

cosine of X, X in radians; use cos(X°) when X is In degrees 



fractional part 
integer part of 



of X"1 



X is first rounded to the nearest Integer 
if X is within 10""9 of the integer for 
|X|<1(55 or within (10*l^x|X|) of the 
integer for |X|>1195 (approximately) 
(base 10) 
(base e) 



common logarithm of X 
natural logarithm of X 
rounded value cf X 

- -1 for X < 'ir^; - 0 for -ir^ iX i 10-9; - +1 for X > 10-5 
sine of Xji X in radians; use sin(X°) when X is in degrees 
square root of X 

address of variable X (X may be a student variable, central memory 
variable, router variable, or defined variable) 
fine-grid x location of character-grid location "X" 
fine-grid y location of character-grid location "X" * 



Logical operations and functions (logical "true" is -1; logical "false" is 0) 



- Y 
* Y 
i Y 
^ Y 
< Y 
> Y 
X$and$Y 
X$or$Y 
not(X) 



equal to 
not equal to 
less than or equpl to 
greater than or equal to 
less than 
greater than 

logical "and"; result is "true' 

logical "or"; result is "true" if either X or Y '^r both are "true 
reverse of truth value of X: if X-0, not(X)— 1; if X«-l, not(X)«0 



equality is "true" if 
|X-Y|<10"9 for IXK100 or 
if |X-Y|<(10*llx|X|O for |X|>100 
( approxima t ely ) 



only if both X and Y are "true" 



Bit operations and functions (use with n-variables) 



X$ars$Y shifts X to the right by Y bit positions 

X$cl8$Y shifts X to the left' (circularly) by Y bit positions 

X$mask$Y set8 bits where bits are set in both X and Y 

X$union$Y sets bits where bits are set in either X or Y 

X$diff$Y sets bits where bits are set in either X or Y 

bltcnt(X) number of bits set in X 

comp(X) one's complement of X (bit reversal) 

ImaskCX) left- justified number with X bits set \ X ranges from 
rma8k(X) 



right-Justified nui^ber with X bits s 



or both 
but not both 



0 to "zbpw" 



System functions are continued on next page* 
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Array functions 



And(X) "true** (--1) if all el3ment8 of array X are "true" 

Max(X) largest element in array X 

Min(X} smallest element in array X 

Or(X) "true" (—1) if any element of array X is "true" 

Prod(X) product of all elements in array X 

Rev(X) reverse of array X; i.e., last element is now first, etc. 

Sum(X) sum of all elements In array X 

Transp(X) transpose of array X; i.e., rows and columns are interchanged 



NOTE: Because of the finite accuracy of any computer , rounding occur? with 
operations with fractional values (v-variables), giving results which 
may be off by only one or two bits but which can lead to serious errors. 
The tolerances indicated with certain functions and logical operations 
are designed to avoid such problems by ignoring these least significant 
bits. However, there is no general solution to this inherent problem, 
and users must design checks for specific applications. 



Some special numerical values: 

1/0 - 03777 0000 0000 0000 0000 
-1/0 - o4000 7777 7777 7777 7777 

0/0 - 01777 0000 0000 0000 0000 
-0/0 - o6000 7777 7777 7777 7777 



Random numbers 



seed specifies a seed for generation of random numbers with -randu- and 

-randp-; remains In effect until execution of another -seed- command 

seed VAR CONTAINING THE SEED VALUE 

seed (B) (clears former value; specifies normal system seed) 

randu selects a random number, sampled with replacement, and places It In 
the specified variable 

randu VAR,MAXIMUM (selects Integer from 1 to MAXIMUM; 

0 £ MAXIMUM < 2^6 ) 
' randu VAR (selects a number from 0 to 1; If the tag Is an 
n-varlable, a value 0 or 1 Is returned) 



NOTE: The next four commands are generally used together to provide random 
numbers without replacements 



setperm single-argument -setperm- sets up two copies of a list of Integers 
from 1 to the specified value for sampling without replacement; the 
first copy of the list Is affected by -randp-; the second copy of the 
list Is affected by -remove- and -restore-; two-argument -setperm- 
sets up one list only; a separate copy of the lis*- should be 
maintained for use with -remove- and -restore- 

setperm MAXIMUM INTEGER IN LIST (0 ^ MAXIMUM < 120) 
setperm MAXIMUM INTEGER IN LIST, STARTING VAR OF LIST 

(for list length > 120 and for special-purpose sampling; 
the first variable of the list contains the number of / 
elements remaining Inl the list, and each succeeding 
variable contains 60 elements in the list; the number of 
variables required Is: 2 + lnt[(MAXIMUM - l)/60]; list 
length cannot exceed 3000 If -randp- Is used for sampling) 



randp selects a random Integer without replacement from the first copy of 
the list set up by -setperm- and places It In the specified variable 

randp VAR (with 1-argument -setperm-) 

randp VAR FOR STORING VALUE, STARTING VAP, G? LIST 

(with 2-argument -setperm- or calculated list) 

Note: With either form of -randp- the value returned Is 0 If the 
first copy of the list Is exhausted. 

With two-argument —randp-, the list length cannot exceed 3000. 
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remove removes the specified value from the second copy of the list set up 
by single-argument -setperm- or from the copy of the list maintained 
for use with two-argument -removes- 
remove INTEGER TOBg REMOVED (with 1-argument -setperm-) 
remove INTEGER TO BE REMOVED, STARTING VAR OF COPY OF LIST 
(with 2-argument -setpenn-) 



restore restores the specified value to the second copy of the list set up 
by single-argument -setpenn- or to the copy of the list maintained 
fdr use with two-argument -restore- 

restore INTEGER TO BE RESTORED (with 1-argument -seCperm-) 
restore INTEGER TO BE RE STORED, STARTING VAR OF COPY OF LIST 
(with 2-argument -setperm-) 



modperm (no tag) replaces the first copy of the list with the current version 
of the second copy of the list, which may have been operated on by 
-remove- and -restore-; paired with single-argument -setperm- only; 
to simulate -modperm- with two-argument -setperm-, use -block- or 
-transfr- to replace the first copy with the second copy of the list 



Information 



name ^ places the slgnon name of the user (up to 18 characters) left- 

justified In two consecutive variables starting at the specified 
varlaWe wltj^ipctal zero fill In unused positions 



name 



STARTING VAR (requires two consecutive variables) 



group places the slgnon group of the user lef t-'justlf led In the specified 

variable, up to 8 characters with octal zero fill in unused positions 



group 



VAR 



compute 



compiles the specified character string into machine code, executes 
the code, and stores the result in the specified variable; the end 
of the character st-ring is determined by the specified number of 
characters, by six bits equal to 0 (o00), or by a comma in the string, 
whichever is attained first; the fourth argument is. a pointer to the 
compiled code and is not required if the string is compiled only once 

compute ARG1,ARG2,ARG3,ARG4 (opt) (invalid expression does not 

compile; once compiled, no recompllation is done unless 
the pointer is zeroed) 

ARGl » variable for storing the numerical result 

ARG2 » character string to be compiled 

ARG3 « number of characters in the character string 

ARG4 « variable for the pointer to the compiled* code (optional) 



Note: 



ARG2 may be a left-justified character string enclosed in 
single quotes (<10 characters) or the starting. variable of a 
left-justified stored character string. The string may contain 
up to 100 characters. A "student"' define set is required if 
the string is to be created during execution of the program. 



clock puts a character string in the specified variable giving time on a 
24-hour clock in the format (space)hour •minute.second . (see also 
' the sj'stem variable "clock") ^ 

clock VAR WHERE STRING IS STORED (use -showa- to display) 

date puts a character string in the specified variable for the current date 
in the format (8pace)month number/day/last two ^igits of year(space) 

date VAR WHERE STRING IS STORED (use -showa- to display) 
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day places in the specified variable the number of days elapsed since 

midnight December 31, 1972 to the nearest 10"^ day (approximately 
•1 second) 

day VAR WHERE VALUE IS STORED (use a v-variable) 

ctime converts the format for the time 

ctime INPUT;OUTPUT;FORMAT (opt) 

INPUT is the time to be ^converted and consists of one of the 
following Sorms: * 

output .from -day- command (one variable; use v-variable) £r 
output from -clock- command (one variable) or 
HOUR,MINUTE (two variables separated by a comma) or 
HOUR,MINUTE, SECOND (three variables separated by commas) 
OUTPUT is the starting variable for storing the string 
containing the converted time (two consecutive variables are 
required); result is left-justified with zero fill; 
if FORMAT is 24, result is hr^mn^sc (or hr.mn if 
2-variablevlnput is used) 

if FORMAT 1^-^12, result is hr:mn:sc pm (or am) (or hr:mn pm 
if 2-variable input is used); if hr is in range 1 to 9, 
* the leading zero is converted to a space 

FORMAT is 12 or 24; if omitted the default for the system is 
used; default for the cerl system is 12 

cdate converts the'^format for the date 

cdate INPUT;OUTPUT;FORMAT (opt) 

INPUT is the date to be converted and consists of one of the 
following forms: i 
output from -day- command (one variable; use v-variable) or 
output from -date- command (one -.ariable) or 
DAY, MONTH (two variables separated by a comma) or 
DAY, MONTH, YEAR (three variables separated by commas) 
OUTPUT' is the variable for storing the string containing the 
converted time; result is left-justified with zero fill; 

if FORMAT is 1, result is mo/da/yr (or mo/da if 2-variable 
input is used) 

if FORMAT is 2, result is da/mo/yr (or da/mo if 2-variable 
input is used) 

if FORMAT is 3, result is yr/mo/da (or mo/day if 2-variable 
input is used) 

a leading zero is converted to a space 
FORMAT is 1, 2, or 3; if omitted the default for the system is 
used; default for the cerl system is 1 (i.e., mo/da/yr) 



Bit and character manipulation 



search , searches a character buffer for a specified object character string 
search ARGl ,ARG2 ,ARG3 ,ARG4 >ARG5 ,ARG6 

ARGl - object string (lef t-justif d) 

ARG2 " number of characters in the string (^10 characters) 
. ^ ARG3 ■ starting variable of the buffer to be searched 

ARG4 ■ total number of characters in the buffer 
ARG5 ■ relative character position at which to start search 
ARG6 ■ variable for storing the relative character position of 
the first occurrence of the object string 



search ARGl ,ARG2 , ARG3 ,ARG4 , ARG5 , ARG6 ; ARG7 



ARGl - object string (left- justified) 

ARG2 ■ number of characters in the string (^10 characters) 

ARG3 ■ starting variable of the buffer to be searched 

ARG4 " total number of characters in the buffer 

ARG5 « relative character fSb'sition at which to start search • 

ARG6 ■ variable for storing the total found count 

ARG7 - number of variables following ARG6 for storing relative 

character positions where the object string is found 

(may be less than total count) 



Note: In both versions of -search- the relative found location is -I 
if the object string is not found. In the second version the 
count is 0 if the string is not found. Relative position of 
the first character is 1, of the second character, 2, etc. 
If ARG4 (length of buffer) is negative, a backwards search 
is done. 



pack packs a character string starting In the specified variable; the string 
will be left-justified with octal zero fill in unused positions; if the 
character count is not desired, the field is left blank 

pack STARTING VAR FOR STORING STRING^VAR FOR STORING 

CHARACTER C0UNT| STRING 
pack STARTING VAR FOR STORING STRING}^ STRING ^ 

Note: Use n-variable(8) for packing the string if subsequent 

comparison for equality with another string is done. (If the 
character string is packed for other purposes, v-variables 
are acceptable.) Segmented variables cannot be used. 
Embedded -show- (and related embeds) may be included in the 
string. Up to 500 .characters (including embedded -show-) may 
be packed, but the tag is limited to one line of code. 
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packc packs one of several character strings into a variable, depending 
on the rounded value of a conditional expression; the string will 
be left- justified with octal zero fill in unused positions; 
if the character count is not desired, the field may be left blank; 
blank argument for the character string leaves the varlable(s) 
unchanged for that value of the conditional expression 

* packc EXPR^ STARTING VAR FOR STORING STRING^ VAR FOR STORING 
CHARACTER COUMT|sTRINGM|sTRING0| STRINGl^l STRINGS. ... 

Note: Up to 100 character strings may be listed. (See -pack- for 
other options and restrictions.) 



move moves character(s) from a specified character position in a 

character string to a specified position in another character string 

move FROM STARTING VAR, FROM STARTING POSITION,TO STARTING 
VAR,TO STARTING POSITION,NUM CHARACTERS (opt) 

move 'STRING' ,FROM STARTING POSITION, TO STARTING VAR, TO 
STARTING POSITION, NUM CHARACTERS (opt) 

Note: If not specified, number of characters is 1. Maximum 
number of characters is 5000. Positions may be >10. 



Itoa converts an integer to a character string, lef t-justlf ijed with 
octal zero fill in unused positions 

itoa NUMBER, STARTING VAR FOR STORING STRING, VAR FOR STORING 
NUM CHARACTERS (opt) * 

Note: Non-integer values are rounded to the\nearest Integer before 
conversion to a character string. ^ 



otoa converts a number from octal format to alphanumeric format (i.e., 
to a character string) for the number of octal digits, if given 
(digits are counted from the right end of the number) 

otoa NUMBER, STARTING VAR FOR STORING STRING, NUM DIGITS (opt) 

Note: Number of digits, if omitted, is 20. 

If number of digits ^10, 1 variable is used for storing the 
string; otherwise 2 variables are used. * 



htoa similar to -otoa- but for hexadecimal to alphanumeric conversion 

htoa NUMBER, STARTING VAR FOR STORING STRING, NUM DIGITS (opt) 

Note: Number of dtlgits, if omitted, is 15. 

If number of digits ^10, 1 variable is used for storing the 
string; otherwise 2 variables are used. 
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clean replaces the following character codes in a buffer with o55 (space): 
000, 066 (subscript), o67 (superscript), o70 (shift), 

o71 (carriage return), o74 (backspace), o75 (font), o76 (access) 

clean STARTING VARIABLE, NUM VARS (opt) (NUM VARS, if omitted, is 1) 



recname takes the 18-character string specified by the first argument, 
removes characters not allowed in signon names, and returns the 
modified string in variables specified by the second argument; each 
string requires two variables; characters allowed are: lower-case 
letters, numerals, apostrophes, accent marks, asterisks, pluses, 
minuses, and blanks (except in the first and last position and in 
contiguous positions); end of the string is marked by o00 

recname^STARTING VAR OF STRING, STARTING VAR OF MODIFIED STRING 

Note: zreturn " -1 if the string is modified successfully 

" 0 if there are no characters in the initial string 
» +1 if there are no characters in the modified string 

Note: A legal signon name must consist of at least one symbol which 
is a letter or numeral. 
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Operations on lists 



sort arranges a list of entries stored In consecutive variables In 

ascending order according to the value of the specified sort field 

sort ARG1;ARG2,ARG3,ARG4,ARG5,ARG6 (opt) 

ARG1A;ARG2A (optional line; allows simultaneous sorting 
of an associated list of entries) 

ARGl * starting location; may be: 
^ STUDENT VAR (v of n) or 

CM VAR (vc or nc) or 

c,EM COMMON LOCATION or 

s,EM STORAGE LOCATION 
ARG2, « number of entries In list 

ARG3 « nunber of variables per entry (or Increment between 

entries); value from 1 to 200 
ARG4 » starting bit position of sort field 
ARG5 «« number of bits In sort field 
ARG6 = mask on sort field (optional) 

ARGIA =» starting location (see ARGl for details) (optional) 
ARG2A =»=»number of variables per entry (optional) 

Note: The field for numerical sorting may not extend across 
boundaries of variables* 



sorta arranges a list of entries stored In consecutive variables In 
alphabetical order according to the Internal codes for the 
characters in the specified sort field 

sorta ARG1;ARG2,ARG3,ARG4,ARG5,ARG6 (opt) 

ARG1A;ARG2A (optional line; allows simultaneous sorting 
of an assoclac ad list of entries) 

ARGl « starting location; may be: 

STUDENT VAR (v or n) or 

CM VAR (vc or nc) or 

c,EM COMMON LOCATION or 

s,EM STORAGE LOCATION 
ARG2 = number of entries in list 

ARG3 « number of variables per entry (or Increment between 
entries); value from 1 to 200 ^ 
ARG4 « starting character posiuion of sort field 
ARG5 « number of characters in sort field 
ARG6 » mask on sort field (optional) 

ARGIA « starting location (see ARGl for details) (optional) 
ARG2A = number of variables per entry (optional) 

Note: Thft field for alphabetical sorting may extend across 

boundaries Aof variables. However, the mask can affect only 
one variable* 
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finds perforas a'^^lnary chop search on a sorted numerical list 
finds ARG1,ARG2;ARG3,ARG4,ARG5,ARG6,ARG7,ARG8 (opt) 

ARGr- starting variable containing the object of the search 

(the object must have the same length and relative 

position as the list entry) 
ARG2 « starting location of the list; may be: 

STUDENT VAR (v or n) o_r ^ 

CM VAR (vc or nc) or 

c,EM COMMON LOCATION or. 

s,EM STORAGE LOCATION 
ARG3 ^ number of entries in the list 

ARG4 * number of variables per entry (or Increment between 
entries); value from 1 to 500 

ARG5 « starting bit position of the search field 

ARG6 " number of bits In the search field 

ARG7 » variable for storing the relative location where the 
object Is found (1st entry Is 1, 2nd, 2, etc); If the 
object Is not found, the variable Is set to the negative 
of the position where the object would have occurred 

ARCS' = mask on search field (op^lonal) 



findsa performs a binary chop search on a sorted alphabetical list 

flndsa ARG1,ARG2;ARG3,ARG4,ARG5,ARG6,ARG7,ARG8 (opt) 

ARGl = starting variable containing the object of the search 
/ (the object must have the same length and relative 

position as the list entry) 
ARG2 " starting location of the list; may be: 

STUDENT VAR (v or n) or 

CM VAR (vc or nc) or 

c,EM COMMON LOCATION _or 

s,EM STORAGE LOCATION 
ARG3 - number of entries in the list 

ARG4 - number of variables per entry (or Increment between 

entries); value from 1 to 500 
ARG5 - starting character position of the search field 
ARG6 number of characters In the search field 
ARG7 " variable for storing the relative location where the 
object Is found (Ist entry Is 1, 2nd, 2, etc); If the 
object is not found, the variable Is set to the negative 
of the position where the object would have occurred 
ARG8 » mask on search field (optional) 



# 
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Inserts Inserts contents of specified buffer into a list of entries stored 
in consecutive variables;^ shifts the remainder of the list down 

inserts ARG1,ARG2;ARG3,ARG4,ARG5,ARG6 (opt) 

ARG1A,ARG2A; ARG3A (optional line; allows simultaneous 

insertion into associated list) 

ARGl * starting variable containing object to be inserted 

(the object must have the same length as a list entry) 
ARG2 « starting location of the list; may be: 

STUDENT VAR (v or n) or 

CM VAR (vc or nc) or 

c,EM COiniON LOCATION or 

s,EM STORAGE LOCATION 
ARG3 • number of entries in the list 

ARG4 ■« number of variables per entry (or increment between 
entries); ARG4 x ARG6 « value from 1 to 500 

ARG5 » relative position in list at which to insert object 
(must be value from 1 ,to 1+length of list) 

ARG6 «• number of entries to insert (optional^ default is 1) 

ARGIA « starting variable containing object to be inserted 
(optional) 

ARG2A « starting location (see ARG2 for details) (optional) 
ARG3A " number of variables per entry (optional) 

deletes deletes the entries at the specified position in a list of entries 
stored in consecutive variables; shifts the remainder of the list 
up and fills the last eiitries with zeros 

deletes ARG1;ARG2,ARG3,ARG4,ARG5 (opt) 

ARG1A;ARG2A (optional line; allows simultaneous deletion 
from an associated list) 

ARGl « starting location; may be: 

STUDENT VAR (v or n) or 

CM VAR (vc cr nc) or 

c,EM COMMON LOCATION or 

s,EM STORAGE LOCATION 
ARG2 « number of entries 'in the list 

ARG3 " number of variables per entry (or increment between 

entries); value from 1 to 500 
ARG4 « relative position in the list of the entry to be 

deleted (must be a value from 1 to length of list) 
ARG5 « number of entries to delete (optional; default is 1) 
ARGlA « starting location (see ARGl for details) (optional) 
ARG2A « number of variables per entry (optional) 



NOTE: Commands -inserts- and -deletes- may be used on sorted or unsorted lists. 
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find searches a list of consecutive variables for the first variable 
containing the specified bit pattern 

find ARG1,ARG2,ARG3,ARG4,ARG5 (opt),ARG6 (opt) 

ARGl - object bit pattern 60 bits; may be variable) 
ARG2 starting variable In the list 
ARG3 number of variables in the list 

ARG4 «• variable for storing the relative location where the 

object is found (relative to the beginning of the list) 
ARG5 « increment between variables (optional) 
ARG6 mask (optional) 

findall searches a list of consecutive variables for all variables containing 
the specified bit pattern 

findall ARG1,ARG2,ARG3,ARG4,ARG5,ARG6 (opt),ARG7 (opt) 

ARGl - object bit pattern (< 60 bits; may be variable) 

ARG2 - starting variable in the list 

ARG3 - number of variables in the list 

ARG4 »• variable for storing total found count 

ARG5 - number of variables following ARG4 for storing the 

relative locations where the object is found (relative 
' to the beginning of the list) (may be less than the 

total count) 
ARG6 - increment between variables (optional) 
ARG7 mask (optional) 

NOTE: Use n-variables with -find- and -findall-. Segmented variables may not 
b^ used* 

Increment^ if omitted, is 1. Negative increment causes a backwards 
search from the last variable in the list. (When search is backwards, 
relative locations are still counted from the beginning of the list.) 
If the mask is omitted; the entire variable is compared with the object 
bit pattern. If a mask is used, the increment must be given, even if 
it is 1. 

Relative location of the first variable is 0, of the second variable, 1, 
etc. 

With -find-, if the bit pattern is not found, the found location is -I* 
With -findall-, if the bit pattern is not found, the count is 0 and the 
first following variable Is -1. 
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Data manipulation 

block copies a set of consecutive student variables (v, n) or central 

memory variables (vc, nc) Into another set of consecutive vailables 

block FROM STARTING VAR,TO STARTING VAR,NUM VARS 

transfr transfers data between v~ and n-varlables (student ;Varlables), 
vc- and nc-varl§ibles (central memory variables), EM common, 
EM storage, or vr- an<f nr-varlables (router variables) (-comload- 
and/or -stoload- must be In effect with central nemory variables) 

transfr FROM STARTING LOCATION;TO STARTING LOCATION;NUM VARS 
(gtneral form) 

Any of the following may be used In the first two arguments of the tag: 
STUDENT VAR (v or n) 

common, EM COMMON LOCATION or c,EM COMMON LOCATION 
storage,EM STORAGE LOCATION "or s,EM' STORAGE LOCATION 
CM VAR (vc or nc) 

router,EM ROUTER COMMON LOCATION ^when placed In "from" 

position, router lesson must contain -allow read-; 

when placed In "to" position, router lesson must contain 

-allow write-) 
routvars,EM ROUTER VAR LOCATION (may be placed only In 

"from" position; router lesson must contain 

-allow read rvars-) 
ROUTER VAR (legal only when -transfr- command is in the 
router lesson) 

for example: 

transfr vl;c,23;10 (transfers variables vl through vl0 to EM 

common locations 23 through 32) 

transfr v6;vc51;9 (transfers variables v6 through vl4 to 

variables Vc51 through vc59) 

transfr s,ll;c,100;21 (transfers EM storage locations 11 through 

31 to EM common locations 100 through 120) 

Note: Limit to length (NUM VARS) which may be transferred is set by: 
tag of -common- or -storage- (when referencing EM) or 
length of -comload- or -stoload- (when referencing CM 

variables) or 
150 (when referencing student variables) or 
tag of -routvar- (when referencing router variables) 

NOTE: For this type of operation, -block- and -transfr- are very fast. 
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common (non-executable) sets up storage space which Is accessible to all 

users in a lesson; in central memory the variables are referenced by 
vc and nc; common codewords must match when the common blocks are in 
a different lesson from the -common- command 

common NUM WORDS, OPTIONS (opt) (temporary common; no common blocks) 
common , COMMON NAME,NUM WORDS, OPTIONS (opt) 

(—common- and common blocks are in the same lesson) 
common LESSON NAME,COMbfON NAME, NUM WORDS,OPTIONS (opt) 

(LESSON NAME is the lesson containing the common blocks) 

" Note: Maximum length is 8000 words. For length i 1500, loading 
and unloading are automatic unless altered by -comload- 
or optional arguments "no load" or "xead only". 
For length > 1500, -comload- must be used tor access to 
central memory variables. Either or both of the following 
OPTIONS may be added to the tag of -common-: 

no load (cancels automatic loading of common from EM to CM) 
read only (prevents transfer of common from CM to EM) 

The following OPTION may be used only with permanent common: 

checkpt (causes common to be returned to disk approximately 
every 8 minutes) 

comload provides automatic loading and unloading of common between central 
memory and EM during each time slice; required if common length 
exceeds 1500 and central memory variables must be accessed 

comload STARTING CM VAR (vc or nc),EM COMMON LOCATION,NUM VARS 

(maximum of 1500 variables) 
comload (B) (unloads CM variables and turns off further automatic 
loading until another -comload- command is executed) 



for example: 
comload vc22,10,8 



(transfers vc22 through vc29 from and to EM 
common locations 10 through 17) 



comret (no tag) returns to disk the common specified by the lesson 

Note: zreturn « -1 if common is successfully returned 

a 0 if no common is specified for this lesson 

» +1 if common cannot be returned 



abort prevents return of information to disk 



ERIC 



abort common 

abort record (with student record; sets "user" to 'sabort' ) 

abort autocheck (with student record; sets "user" to 'snockpt' ) 

abort lf».slist ^ 



0 
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commonx similar to -common- except that -commonx- is executable; If the 

•^ommonx- command and common blocks are In different lessons, the 
common codewords must match or the codeword argument must be given; 
the codeword argument must match the common codeword on the lesson 
containing the blocks; if any optional arguments are included, the 
fields for intervening missing arguments must be present 

commonx , COMMON NAME, NUM WORDS (opt) , CODEWORD^ (opt) , OPTIONS (opt) 

(-commonx- and common blocks are in the same lesson) 
commonx LESSON NAME, COMMON NAME, NUM WORDS ( ont ), CODEWORD (opt), 
OPTIONS (opt) 

commonx <LESLIST P0SITI0N>,C0MI10N NAME,NUM WORDS (opt), 

CODEWORD (opt), OPTIONS (opt) 
commonx (B) (disconnects current common, copies it to disk if no 

other users are in the common, and turns off comloading) 

Note: Variable name and codeword arguments must be enclosed in 
parentheses* 

If NUM WORDS is omitted and common is in EM, the EM length is 
used; if common is not in Eit, entire common is r^ad from disk* 
OPTIONS are the same as for -common-* 

zreturn » -1 if execution is successful 

* 0 if the common is not found or no common is in use 

» 1 if no codewords match 

" 2 if the lesson already has a common 

» 3 if the length of the EM version of the common 

is different from the declared length 

» 4 if the declared length is illegal ^ 



initial specifies a unit to be executed by the first user to enc(unter this 
command when a lesson or common is first brought into EM 

initial common, UNIT NAME (not executed if common is in another 
lesson which is already in EM and in which 
-initial common- has already been executed) 

initial lesson,UNIT NAME ^ 

storage (non-executable) sets up storage space which serves as a temporary 
extension of student variables; in central memory the variables are 
referenced by vc and nc; they are not saved in student records and 
are zeroed during jumpout to another lesson (see -inhibit dropstor-) 

storage NUM WORDS (maximum length of 8000) 

storage NUM WORDS, exactly (lesson requires the exact amount of 
storage specified) 

storage NUM WORDS, minimum (lesson requires the greater of the amount 
of storage specified or the amount present when the lesson 
is entered with -inhibit dropstor- in effect) 
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stoload similar to -comload- but refers to storage; required for any 
length storage, to access central memory variables 

stoload STARTING CM VAR Xvc or nc),EM STORAGE LOCATION,NUM VARS 

(maximum of 1500 variables) 
stoload (B) (turns off automatic loading and unloading of storage) 

NOTE: When both -conload- and -stoload- are used, care must be taken that the 
addresses of central roeiaory variables Into which common has been loaded 
do not overlap with the addresses into which storage has been loaded • 

reserve sets system variable "zreturn" in order to allow a user to reserve 
the common to prevent changes by core than one user at a time 

reserve common 

Note: zreturn ■ -2 if the common is already reserved by this user 
» -1 if -reserve- is executed successfully by this 
user 

» station number of user who has already reserved 
the common 



release sets system variable "zreturn" to allow the common to be released 
release common 

Note: zreturn - -2 if the common is not reserved by any user 

» -1 if -release- is executed successfully by this 
user 

» station number of user who has reserved the common 

backgnd (no tag) flags a lesson as a "background" lesson so that it may use 
large amounts of CPU time when the tine is available; when CPU time 
is scarce, the lesson is handled at lower priority than non- 
background lessons 

foregnd (no tag) switches the lesson to foreground processing; normal state 
of execution 
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System variables for calculating 



Icommon length of common (set by tag of -common- command or -coramonx- command) 



Istcrag length of storage (set by tag of -storage- command) 



\ 

zbpc number of bits per character (currently 6) 



zbpw number of bitScper computer word (currently 60) • 



2cpw number of characters per computer word (currently 10) 



zcusers number of users signed into the current common 

\ 
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DATA KEEPING . Dl 



Requesting data 

dataon specifies that student data for the lesson Is to be collected and 
•sent to a datafile If the student records have been set to allow 
collection of data i^ee also system vari5\ble "dataon") 

dataon -(B) (turns on all data collection) 

dataon TAG (TAG can be ok, no, unrec no, vocab, area, output, 
help, help no, term, term no, errors, signin) 

Note: Non-blank tag will temporarily override; options set in 
group records until turned off by -dataoff- with the 
appropriate tag. 

dataoff specifies termination of collection of data for that lesson 
dataoff (B) 

dataoff TAG (TAG is same as that used in a preceding -dataon-) 

"Note: Non-blank tag of -dataoff- will turn off only options 
turned on by a previous -dataon- with a non-blank tag;' 
-dataoff- does not override options set in group records. 



Classifying data 



area specifies a section In the lesson (called an area) typically 

representing 5 to 15 minutes of student contact time for which 
certain Information Is collected 

area NAME (maximum of 10 characters in NAME; cannot start wi^h 
a number; variable tag must be enclosed in parentheses!^ 

Note; . Information collected: \ 

i 

elapsed time in the area (in minutes; accurate to .1 minute) 
number of arrows encountered 
number of "ok" judgments 

number of responses judged "ok" on 1st attempt 
number of anticipated "no" judgments, or "wroug" judgments 
number of unanticipated "no" judgments 
^ number of term requests satisfied 

number of term requests not satisfied 
number of help-type requests satisfied 
number of help-type requests not satisfied 
' whether the area has been completed 

area (B) (causes data for the preceding area to be placed in 
the datafile; no further data is stored until -area- 
with nonblank tag is executed) 

area incomplete (terminates the current area , and flags it as 

incomplete) 

area cancelled (cancels all data for the current area; does not 
initiate a new area or produce any records in the datafile) 

output puts a comment and/or value of an expression into the datafile' 

output COMIIENT AND/OR EXPR (formats for the expression are: 

n, V, a, o, h with embedded form, i.e., <FORMAT,EXPR> ) 

outputl places labeled information from specified student variables in 
the datafile 

outputl LABEL (opt), STARTING VAR,NUM VARS (maximum of 

10 characters in LABEL and 20 consecutive variables) 

setdat allows alteration of system variables containing area data 
setdat SYSTEM VAR4« EXPR 

Note: "atime" cannot be set to a value greater than the total time 
signed on for that session. It is accurate to 0.1 second. 
The remaining system variables (except for "aarea") can be 
set to values up to 511. 
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Transferring data 



readset establishes a link between a dataflle and the lesson which receives 
the data 

readset DATAFILE NAME, *DATAFILE CHANGE OR INSPECT CODEWORD' (cpt) 

VAR FOR STORING NUM UNUSED BLOCKS (opt) 
readset <LESLIST POSITION>, 'DATAFILE CHANGE OR INSPECT 

CODEWORD' (opt), VAR FOR STORING NUM UNUSED BLOCKS '(opt) 

Wote: The second argument Is Included If codewords on the lesson and 
dataflle do not match* Variable file name must be enclosed In 
parentheses; If the codeword Is a variable, quote marks are 
omitted. The third argument Is If the dataflle Is full. 



zreturn » -1 If the dataflle exists and Is not empty 

« 0 If the name specified Is not a dataflle 

« 1 if codewords on the lesson and dataflle do not 
match 

« 2 If the dataflle Is empty 

» 3 If there Is no room In EM for the buffer 

» 4 If there Is a disk error 



readd transfers data from a dataflle Into student variables or central 

memory variables (must be preceded by -readset- naming the dataflle) 



readd area, STARTING VAR,NUM VARS 

Note: Area summary data consists of the following Information: 



n(x) or nc(x) " 

n(x) and n(x+l) 

n(x+2) contains 

n(x^3) 

n(x+4) 

n(x+5i) 

n(x+6) 

n(x+7) 

n(x+8) 



n(x^9) 

n(x+10) 

n(x+ll) 

n(x+12) 

n(x+13) 

n(x+14) 

n(x+15) 



-1 If 
•1 if 



starting variable 

contain the user's name (up to 18 characters) 
the lesson name 
the area name 

elapsed time for the area (In milliseconds) 

number of arrows for the area 

number of "ok" judgments for the area 

number of "ok" judgments on the 1st attempt 

number of anticipated "no" judgments (matched by 

-wrong-, -wrongc-, -wrongu-, -wrongv-, -miscon-, 

-touchw-, or -judge wrong-) 

number of unanticipated "no" judgments 

number of help-type requests satisfied 

number of help-type requests not satisfied 

number of term requests satisfied 

number of term requests not satisfied 

the area was completed, »0 If not 

the area Is a continuation, «0 otherwise 



V 
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readd outputl, STARTING VAR,NUM VARS 

Note: Data from -outputl- consists of the following information; 
n(x) or nc(x) « starting, variable 

n(x) contains the length of -outputl- (number of variables) 
n(x+l) and n(x+2) contain the user's name (up to 18 characters) 
n(x+3) contains the lesson name ^ 
n(x+4) " the area name / 

n(x+'^) " execution tin^e of -outputl- in milliseconds 
n(x-*-5) " -outputl- label 

n(x+7) to n(x + NUM VARS -1) contain data in the tag of -outputl- 
readd signoff, STARTING /^AR, NUM VARS 

Notei Signoff data consists of the following information: 
n(x) or nc(x) • starting variable 

n(x) and n(x+l) contain the user's name (up to 18 characters) 
n(x+2) contains the lesson name 

n(x+3) " elapsed time (in minutes) spent in the lesson 
during this session 

n(x+4) " total time (in minutes) to complete the lesson 

if the lesson is completed during this session or 
-1 if the lesson is not completed during this session 

n(x+5) " date of session 

n(x+6) " time of signoff 



Note: With all tags for -readd-, 

zreturn » -1 if there is more data in the datafile 
« 0 if the end of the datafile is reached 



4 ^ 



C 



D5 



Signing on and off 

restart specifies unit (and lesson If given) where the student Is to begin 
at the next session 

restart (B) (start at the main unit containing' this command) 
restart UNIT NAME (start In this lesson at the specified unit) 
restart LESSON NAME, UNIT NAME (start in the specified lesson at 

the specified unit) 
restart <LESLIST POSITION>,UNIT NAME (start in the lesson at the 
specified lesllst position, in the specified unit; 
variable unit names must be enclosed in parentheses) 
* restart (0)>(0) or restart q (clears restart information; 

no restart is in effect) 



specifies the unit which will be executed upon exit from the lesson 
via STOPl (but not via -end lesson- or -jumpout-) 

finish UNIT NAME 

finish (B) or finish q (clears -finish- setting) 
finish EXPR,NAMEM,NAME0,q,NAME2,x (example of conditional form; 
maximum of 10^ arguments in the conditional tag) 

1 \ 

specifies whether -restarts commands (except those restarting to a 
specific unit in another \le^i?son) are obeyed for students in groups 
with short records; has no effect for students with regular records 

permit short recs (permits -restart- commands except to a specific 

unit in another lesson) 
permit (B) (permits only -restart*" commands which do not specify 
a unit; default condition) 



finish 



permit 



D6 

System variables for data keeping 
collecting data 



dataon * -1 if data collection is turned on 
* 0 if data collection is off 
(see also command -dataon-) 



session data 

zsesset elapsed time since the beginning of this session (in seconds, to the 
nearest millisecond) 

zsesspt processing time during this session (in seconds, to the nearest 
millisecond) 

zsessda number of disk accesses since sign-on during this session 
area data 

aarea name of current area (left-justified, display with -showa-) 
aarrows number of arrows encountered 
ahelp number of help-type requests satisfied 
ahelpn number of help-type requests not satisfied 
aok number of "ok" judgments 

aokist number o^ "ok" judgments on the first attempt 

asno number of specified (anticipated) "no" judgments; also referred to 
as "wrong" judgments, where "judged" has been set to 0 

aterm number of term requests satisfied 

atermn number of te.rm requests not satisfied 
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atlme elapsed time In the area (In milliseconds) 



auno number of unanticipated "no** judgments; **judged** has been set to +1 



NOTE: The system variables containing area data are zeroed at the beginning 
of each area. 

"atlme** may have a value up to about 9 hours* 

The remaining variables (except **aarea**) may have values up to 511. 



• 




FILE OPERATIONS 
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Attaching and accessing files 



attach establishes a connection with a file and permits access to disk records 
or blocks for dataset, nameset, group, TUTOR (lesson), or code files; 
with datasets and namesets record size may be from 64 to 512 words 

attach NAME, (for read and write access) 

attach <LESLIST POSITION> 

attach- NAME,rw, 'CODEWORD' (opt) (for read and write access) 

attach <LESLIST POSTION>,rw, 'CODEWORD' (opt) 

attach NAME,ro, 'CODEWORD' (opt) (for read-only access) 

attach <LESLIST POSITION>,ro, 'CODEWORD' (opt) 

Note: Codeword checks between lesson and file: 

Codeword argument omitted, read and writ^j access: 

attach codeword on lesson must match cha,ige codeword (TUTOR file, 

code file) or write records codeword (nameset, dataset, 

group file); 

processor lesson — read/write o£ special write or dual access 
(user's editing codeword [or group or account] must ma^cch 
tHe codeword for writing into the file) 
Codeword argument omitted, read-only access: 

attach codeword on lesson must match change or inspect codeword 
(TUTOR file, code file) or write records or read records 
codeword (nameset, dataset, group file); 
processor lesson*^read only, read/write, or dual access or^ 
special read or special write (user's editing codeword [or 
group or accoun^J must match co'^eword for reading the file) 

Codeword argument Included: both read/write and read only: 
CODEWORD (typable) must make same match as attach codeword • 

Variable file name must be enclosed in parentheses* 

Quote marks on variable codeword argument are omitted. 

"rw" may be replaced by an expression with value 

"ro' may be replaced by an expression with value 0* <^ 

TUTOR files and code files are always "read only"/ When 

the file is attached with "rw", it cannot be edited by the 

system editor or attached with "rw" access at another station. 



zretum " 
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1 
2 



3 
4 



if connection to the file is suc:cessful 

if the file does not exist or is the wrong type 

if no codewords match 

if a user at another station is editing the file 
directory or has attached a TUTOR file or code 
file with "rw" access (or is editing tlie file) 
if there is an error in the directory of the file 
if a disk error has occurred 



^detach disconnects a file from the lesson 

detach NAME (detaches and releases the specified file, whether 
active or inactive) 
Q detach <LESLIST POSITION> 

gp^i^" ^etach <B) (detaches and releases the current active file) 



\ 



\ 
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checks the specified custom access list in the specified lesson for 
the user^s name, group, and account and returns the user^s access 
flags In the bits of the specified variable 

access LESSON NAME, BLOCK NAMEjVAR FOR STORING ACCESS BITS 

access , BLOCK. NAME; VAR FOR STORING ACCESS BITS (the access list is 

in the lesson containing the -access- command) 
access <LESLIST POSITION>, BLOCK NAME;VAR FOR STORING ACCESS BITS 

Note: Variable lesson and block names must be enclosed in parentheses 

zreturn ■ -2 if the user's access flags are returned and the 
user is the owner of the access list 

« -1 if the user^'s access flags are returned 

* 0 if this list is not a custom access list 

« I if the lesson is not found 

« 2 if the access list is not found 

« 3 if there is a system error 
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Datasets and namesets 

NOTE: When -datain'-, -dataout-, .-reserve-, -releas^ are used with namesets, 
the record designations are relative to the selected named records. 

datain transfers data frpm disk to the specified buffex 

datain STARTING RECORD NUMBER; TO STARTING LOCATlb^; NUld RECORDS (opt) 

dataout transfers data from a buffer to disk 

dataout STARTING RECORD NUMBER; FROM STARTING LOCATION; NUM RECORDS (opt) 



NOTE: With -datain- and -dataout-* the second argument in the tag may be: 
STUDENT VAR or c,EM COMMON LOCATION _or_ s,EM STORAGE LOCATION 
If omitted, the number of records transferred is 1 • 



zreturn 



-1 
0 
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if -datain- or -dataout- is executed successfully 

if there is a pack ex'ror or if the disk containing the 

file is not available 

if the file has the wrong type, if no file is attached, 

or if no name has been selected 

if record numbers extend out of range 

if the required buffer locations extend out of range 

(-^ataout- only) if the user does not have write access 

(-dataout- only) if record(s) is reserved by another user 

If there is a disk error 



reserve reserves file records or the directory to prevent changes by more 
than one yser at a time 

reserve records, STARTING RECORD NUMBER, NUM RECORDS 
reserve name (reserves all records in the selected name) 
reserve file (I'eserves all records in the attached file) 
reserve directory (reserves the file directory) 



Note: zreturn - 



-2 if the records are already reserved by this user 

- -1 if -reserve- is executed successfully by. this 

user 

- 0 if no file is attached or if ao name has been 

selected 

1 if record numbers extend out of range 
« 2 if the user does not have write access 
«• 5fn, where n«station number of the user who has 

reserved these records 
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release releases file records or the directory 

release .records, STARTING RECORD NUMBER, NUM RECORDS 
release name (releases records in the selected name) 
release file (releases all records in the attached file) 
release directory (releases the file directory) 

Note; zreturn " -2 if the records are net reserved by any user 

m -I if -release- is executed successfully by this 
user 

" 0 if no file is attached or if no name has been 
selected 

" I if record numbers extend out of range 
" 5+n, where n"station number of the user who has 
reserved these records 



NOT?: With the following commands . (-setname-, -getname-, -addname-, -rename-, 
-addrecs-, -delrecs-, -delname-, -names-), the name can be up to 30 
characters long (3 variables). The optional extra information for the 
name is stored in the right-most 24 bits of the specified variable. 

setname selects a name (i.e., named set of records) in a nameset 

setname 'NAME* (NAME can contain up to 10 characters; if the name 

length in the nameset is more than 10 characters, the tag 
^ literal is filled out on the right with ::eros) 
setname STARTING VAR CONTAINING NAME 

setname nextname (selects the next name in alphabetical order or 
the first name if a name has not already been selected) 

setname backname (selects the preceding name in alphabetical 'order 
or the last name if a name has not already been selected) 

setname (B) (clears the name currently selected) 

Note: zreturn » -1 if the specified name matches exactly a name 

in the nameset 
" 0 if the sbecified name matches one name for the 

given number of characters; selects that name 
- 1 if the specified name matches more than one 

name for the given number of characters; 

selects the first of the names 
» 2 if the specified name does not match any name; 

the name reference is cleared 
" 3 if no nameset is attached 

(With tags "nextname" and "backname", "zreturn" can have only 
values -1, 2, or 3.) 
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getname stores the name currently selected and its associated extra 



information^ if specified; the name is lef t~justl^ed and unused 
character positions are filled with octal zeros; the^ extra information 
is stored in the right-nnost 24 bits of the specified variable and 
remaining bits are cleared 

getname STARTING VAR FOR STORING NAME,VAR FOR STORING EXTRA 
INFORMATION (opt) 

Note: If no name has been selected, a value of 0 is stored for both 
the name and the extra information. 



addname adds a new named set of' records to a nameset file; selects that name 



addname STARTING VAR CONTAINING NAhE,NUM RECORDS (opt), VAR 
CONTAINING EXTRA INFORMATION (opt) 

jNote: Number of records, if omitted. Is 1, 
Extra information. If omitted. Is 0» 

zreturn « -1 if the name is added successfully 



« 0 if no nameset is attached 

« 1 if the user does not have write access 

" 2 if the new name duplicates an existing name or 

has an Illegal format 
« 3 if enough room is not available for new records 
« 4 if the nameset is reserved 



rename clanges the name of the currently selected named set of records 



and/dr the associated extra information 

rename STARTING VAR CONTAINING NEW NAME, VAR CONTAINING NEW 
INFORMATION. (opt) 

Note: If the second argument is omitted, information is unchanged. 

zreturn « -1 if the name is changed successfully 
«* 0 if no nameset is attached 
« 1 if the user does not have write access 



« 2 

- 3 



if no name has been selected 

if the new name duplicates an existing name or 
has an illegal format 

if records in the selected name are reserved 



« 4 



'oh 



addrecs adds records to the serected name 



addrecs NUM RECORDS TO ADD AT END 

addrecs RECORD POSITION, NUM RECORDS TO ADD AT THAT POSITION 

Note: zreturn - -I if records are added successfully 

= 0 if no naraeset is attached 

- I if the user does not have write access 
" 2 if no name has been selected 

" 3 if the specified starting position is outside 
the range of records in the named records 
(2-argument form) 

» 4 if records in the selected name are reserved 

- 5 if enough room is not available for new records 



delrecs deletes records from the selected name (but does not zero the records) 

delrecs NUM RECORDS TO DELETE FROM END 

delrecs STARTING RECORD POSITION, NUM RECORDS TO DELETE 

Note: zreturn - -I if records are deleted successfully 

" 0 if no nameset is attached 

- I if the user does not have write access 

- v2 . if no name has been selected 

" 3 if the specified starting position is outside 
the range of records in the named records 
(2-arguaent form) 

» 4 if the specified records are reserved 



delname (no tag) deletes the currently selected name and all its records 
(but does not zero the deleted records) 

Note: zreturn ■ -I if the name and records are deleted successfully 
- 0 if no nameset is attached 
" 1 if the user does not have write access 
" 2 if no name has been selected 
« 4 if the specified records are reserved 
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names stores names from the nameset (names are stored left-Justified with 
octal reros in unused character positions); each name entry, which 
may require from 1 to ^3 variables, is "followed by a variable whose 
left-most 15 bits contain the number of records with the name and 
whose right-most 24 bits contain the extra information 

names ARGl (opt ) ,ARG2 ,ARG3 , ARG4 

ARGl " startinjg position in list of nameset names (optional) 
(if omitted, starting position is the name currently 
selected by -setname- or the beginning of the list if 
no name is selected) 

ARG2 " starting variable for storing names 

ARG3 « maximum number of variables for storing names (each 
requires from 2 to 4 ^riables) ^ 

ARG4 variable for storing actual number of names obtained 

^ » 

Note: zreturn « -1 if names are stored successfully 
» 0 if no nameset is attached 
« +1 if the starting position is invalid 



Group files 



The following conunands for namesets may also be used with group files: 
-setname-, -getname-, -names-, -addrecs-, -delrecs-^ -reserve-, -release-, 
-datain-, and -dataout-. 



The -records- command provides information on a group file. 

0 

NOTE: With -records- command, change access changes the parameter t£ the 

infcriaation contained in the specified variable(s); read access stores 
th^ parametsr JLn the specified variable(s). 

To change alphabetic information use a left- justified string (^10 
characters) or n-type variable(s) containing a left-justified string. 
To read (store) alphabetic information use n-type variables* 
(Alphabetic information is stored left-justified.) 



records change and records read allow parameters for the previously 

selected name to be changed or read 

records change;OPTIONl;OPTION2;OPTION3. . . 
records read;OPTIONl;OPTIoS2;OPTION3. . . 

OPTIONS: 



name, STARTING VAR (name of the record; requires 2 variables) 
user type, VAR (read only; stores user type, e.g., 'student*) 

off, VAR (VAR is -1 for record turned off, 0 otherwise) 
info, VAR (the 24 bits of extra information) 

options, 'TYPE* , VAR (author and instructor options; VAR- is -1 for 
option turned on, 0 for option turned off; *XYPE* may be 
•if ilecat* , 'anyless* , 'sitelist* , 'userlist* , 'notes* , 
'accounts* , 'datafile* , 'prints* , *editown* , *editothr* ) 

svars, STARTING ADDRESS, STARTING VAR,NUM VARS (student variables) 

rvars, STARTING ADDRESS, STARTING VAR,NUM VARS (router variables) 

message, STARTING VAR (requires 31 variables) 

lesson, VAR (name of the restart lesson; change: lesson entry may 

be a leslist position, e*g*, change; lesson, <LESLIST POSITION>) 
unit, VAR (name of the restart unit) 

score, VAR (last value of **lscore**) 

completed, VAR (last value of **ldone**) 
status, VAR (last valus of **lstatus**) 

Idonelist, STARTING LESSON POSITION, STARTING VAR,NUM VARS (read only; 

*'ldone** information, in 3-bit signed segments; **mrouter** only) 
Iscorelist, STARTING LESSON POSITION, STARTING VAR,NUM VARS (read only 

**lscore** information, in 8-bit signed segments; **mrout *r** only) 
-■^ <^ j^^^ on, VAR (VAR is -1 for individual data collection on, 0 for off) 

(-records change - and -records read- continued on next page) 
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data opts, 'TYPE* ,VAR (individual data collection options; VAR is -1 
for option turned on, 0 f^r option turned off; 'TYPE' may be 
'area' , 'output' , 'ok' , 'no' , 'unrec no' , 'vocab' , 'help' , 
'help no' ^ 't^rm' , 'term no' , 'errors' , 'signin' ) . 
password, TYPE, VAR (opt) (change: TYPE— 1, set password to string 
in VAR; TYPE"0, zero password; TYPE"1, set password to none; 
read: TYPE is a variable which stores the value for type of 
password [-l,^ypable password; 0, blank; 1, none required]) 
total time, VAR (read only; total hours on PLATO; use^ v-variable) 
(read only; total days on PLATO) 
(read only; total sessions on PLATO) 
(read only; total cpu time in milliseconds) 
(read only; totaj^ disk accesses) 
(read only; date of creation of the name) 
(read only; date the name was last signed on) 
(read only; time the name was last signed on) 
(read only; station number where name was last signed on 
(read only; stores "zid" information) 



total days, VAR 
sessions, VAR 
cpu time, VAR 
disk count, VAR 
creation, VAR 
last date, VAR 
last time, VAR 
station, VAR 
id^VAR 



Note: See "zreturn" on next page. 



records add and records delete permit names to be added or deleted 

records add; name, STARTING VAR;user type, 'USERTYPE' ;0PTI0Nl;0PTI0N2. • • 
records delete (deletes the selected name and its records; zeros 

records with basic signon data but not extra records) 

OPTIONS are those for previously selected name. 
With -records add- "name" and "user type" are required; other 
options are allowed for initializing values. If no options are 
specified, the parameters are created with value of zero. 
•USERTYPE' may be 'student' , 'multiple' , 'instructor' , or 'data' . 
(Type 'author' may be created in author group files which do not 
contain University of Illinois authors.) 

A 'data' us-^r type may be used for storing data for the group as a 
whole. A name with this user type cannot sign onto the system. 

Note: See "zreturn** on next page. 



records changedir and records readdir allow information in the group 

directory to be changed or read 

records changed ir; OPTIONl ;OPTION2;OPTION3 . . . 
records readdir;OPTIONl ;0PTI0N2 ;0PTI0N3 . . . 

OPTIONS : 

name, VAR (read only; name of last editor) 

group, VAR (read only; group of last editor) 

(-records changedir- and -records readdir^- continued on next page) 
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station, VAR (read only; station where last editor worked) 

lesson, VAR (read only; lesson which last edited the group) 

date, VAR (read oitly,;^ date the group was last edited) 

time, VAR (read only; time the group was last edited) 

short, VAR (read only; VAR is -1 If the group has short records, 

0 If the group has regular-length records) 
8notes,VAR (read only; name of student notes file) 

data file, VAR (read only; name of dataflle) 
processor , VAR (read only; name of processor lesson) 

router, VAR (name of student router; may not be set to a system lesson; 

change: lesson entry may be a lesllst position, e.g., 

changedlr; router, <LESLIST POSITION» 
irouter,VAR (name of • Instructor router; change: If VAR='0, router Is 

set to "Imode"; may not be set to any other system lesson; 

change: lessbn entry may be a lesllst position, e.g., > 

changedlr;! router, <LESLIST POSITION>) 
group data, 'TYPE* ,VAR (group data collection options; VAR Is -1 for 

option turned on, 0 for option turned off; 'TYPE' Is same as 

for Individual data opts) 
less data, 'TYPE* ,VAR (lesson data collection options; VAR Is -1 for 

option turned on,- 0 for option turned off; 'TYPE' Is same as 

for individual data opts) 
write code, TYPE, VAR (opt) (write records codeword; change: TYPE='-1 , 

set codeword to string in VAR; TYPE=1, set to unmatchable 

codeword; TYPE«2, set codeword to user^'s group; TYPE=3, set 

codeword to user's account; 

read: TYPE is a variable which stores the value for type of 
codeword (-1, typable code; 1, unmatchable; 2,. group; 3, account]) 
read code, TYPE, VAR (opt) (read rcicords codeword; TYPE is same as for 
write code) 

message, 'TYPE' , STARTING VAR, VAR FOR DATETIME (opt) (message requires 
31 variables; 'TYPE' 'all' , 'student', 'multiple', 'instructor', 
or 'author'; for read-only acdess, date and time the^ message 
was written may be returned in the optional argument as a 
character string in the form: yriandyhrmt where yr is the 
last 2 digits of the year; mn is month number; dy is the day 
of the month; hr is the hour; mt is the minute) 



NOTE: For all preceding forms of the -records— command: 

zreturn « --1 if -records- is executed successfully 

=» 0 if no group is attached or if no name has been selected 

» 1 if the user does not have write access 

» 2 if the new name duplicates an- existing kame 

= 3 if there is not enough disk space availaMe 

« A if the entire group or the name is reserve"^ by another user 

« 5 if there is a disk error x 

^ 6 if there is an error in the (n-S)^^ OPTION in. the 
-records- tag, where, n is the "zreturn" value 
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records locate 



stores the station numbers where names In the group are 
signed on; the search stops vhen the first name Is found 



records locate, STATION NUMBER TO START SEARCH (opt);VAR 

(If STATION NUMBER Is omitted, search starts at station 0; 
VAR Is set to the station number where the first name Is 
found or to -1 If no names in the group are signed on at 
stations ^ STATION NUMBER) 

Note: zreturn » -1 If -records locate- Is executed successfully 

» 0 If no group Is attached 

^» 2 If the station number Is Invalid 

« 5 if there Is a system error 



records Info 



stores information for the name signed on at the specified 
station or for the previously selected name 



records info, STATION NUMBER (opt);0PTI0Nl;0PTI0N2;.*. 

(if STATION NUMBER is omitted, data is stored for the 
selected name) 

OPTIONS: 



name, STARTING VAR 
user type, VAR 
lesson, VAR 
main, VAR 
current, VAR 
router, VAR 
curriculum, VAR 
zxflle,VAR 
hours on, VAR 

cpu time, VAR 
disk count, VAR 
router ecs, 'TYPE* , 

lesson ecs, 'TYPE* , 

area, VAR 
station, VAR 
site, VAR 
status, VAR 
score, VAR 
completed, VAR 



(name of the record; requires 2 variables) 

(type of record, e.g., 'student') 

(name of the lesson or type of activity) 

(name of the main unit) 

(name of the current unit) 

(name of the router lesson) 

(name of the curriculum file or instructor file) 
(name of the processor lesson database) 
(number of hours signed on for this session; 
use v-varlable) 

(cpu time in milliseconds for this session) 
(number of disk accesses for this session) 
VAR (router EM charges; 'TYPE* is lesson* , 

'common* , 'storage* ) 
VAR (lesson EM charges; 'TYPE' is lesson' , 
'common' , 'storage' ) 
(name of the current area) 

(number of the station where the name is signed on) 
(name of the site at which the name is signed on) 
(current value of "Istatus") 
(current value of "Iscore") 
(current value of*"ldone") 



Note: zreturn « -1 
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if -records info- is executed successfully 
if no group is attached or if no name has been 
selected 

if the selected name is not signed on or if no 
name in the group is signed on at the specified 
station 

if there is a system error 

if there is an error in the (n-S)^^ OPTION in the 
-records- tag, where n is the "zreturn" value 
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records send sends a message (up to 60 characters) to the station or rings 
the sound device on the terminal (If programmable) 

records s«nd,STAtION NUMBER(opt);message» SCREEN LOCATION, STARTING VAR 

CONTAINING MESSAGE, NUM CHARACTERS IN MESSAGE 
records send, STATION NUMBER(opt) ;beep 

(If STATION NUMBER Is omitted, the message or signal Is 
sent to the selected name) 

Note: zreturn « -I If the message or signal Is sent successfully 
» 0 If no group Is attached or If no name has been 
selected 

» 1 If write access to the group Is not allowed 
« 2 If the selected name Is not signed on or If no 

name In the group is signed on at the specified 

station 

=• 4 If the message or signal cannot be sent to the 

specified station 
» 5 If there Is a system error 

records backout backs out the specified station or the previously selected 

name after erasing the screen and sending a message (sets 
"backout" to -2) 

records backout, STATION NUMBER (opt) (if STATION NUMBER is omitted, 

selected name is backed off) 

Note: zreturn « -1 if the backout is successful 

* 0 if no group is attached or if no name has been 
selected 

= 1 if write access to the group is not allowed 
» 2 if the selected name is not signed on or if no 

name in the group is signed on at the specified 

station 

» 3 if the station is not backed out because of error 
=« 4 if the specified station cannot be backed out 
= 5 if there is a system error 
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records update updates the disk copy of the records for this user (student 
or instructor); the user's group must be attached with 
read/write privileges, and the user's name must be selected 
with -setname- 

Note: zreturn " if updating is successful 

■ 0 if no group is attached or if no name has been 
selected . 

« I if write access to the group is not allowed 
« 2 if the wrong group is attached or the wrong 

name has been selected 
» 3 if checkpointing has been turned off by 

-checkpt off- or -records save- 
» 4 if the selected name is not user type 'student* 

or 'instructor' 
» 5 if there is a disk error or other system error 



records save 



similar to -records update- except that the record is flagged 
as "saved" and automatic checkpointing is turned off; can be 
used only in a router lesson ^ 



Note: zreturn 



-I if -records save- is successful 

0 if no group is attached or if no name has been 
selected 

1 if write access to the group is not allowed 

2 if the wrong group is attached or the wrong 
- name has been selected 

3 if -checkpt off- is in effect or i^ the record 
has already been saved 

4 if the selected name is not user type 'student* 
or 'instructor* 

5 if there is a disk error or other pystem error 



records restore 



retrieves the saved record from disk; used with 
-records save-; can be used only in a router lesson 



Note: zreturn » 



-1 if -records restore- is successful 

0 if no group is attached or if no name has been 
selected 

1 if write access to the group is not allowed 

2 if the wrong group is attached or the wrong 
name has been selected 

3 if the record has not been saved by -records save- 

4 if the selected name is not user type *student* 
or *instructor* 

5 if there is a disk error or other system error 
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checkpt allows the program t;o control checkpointing of student and instructor 
records; a -checkpt- command executed in a router sets the default 
for checkpointing for subsequent instructional lessons 

checkpt on (allows automatic checkpointing; normal default for 
students) 

checkpt off (prevents automatic checkpointing; normal default for 
instructors) 

checkpt EXPR (value»0 sets to "off"; valuG«-l sets to "on") ^ 

Note: zreturn « -1 if -checkpt- is successful 

» 0 if -checkpt- cannot be used with this user type 
( 'multiple* , 'author* , 'sabort* , *snockpt* ) 
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TUTOR files and code files 



V 



setname selects a block name from the attached file; contiguous blocks .with 
the sai&e name are selected at the same time 

setname *NAME* 

setname VAR CONTAINING NAME 

setname nextname (selects the next name In sequence or the first 

name If a name has not already been selected) 
setname backname (selects the preceding name In sequence or the 

last name if a name has not already been selected) 
setname (B) (clears the name currently selected and selects source 
blocks set to condense) ^ 

Note: zreturn ■ -1 if the specified name matches exactly a block 

name in the file 
■ 0 If the specified name matches one name for the 

given number of characters; selects that name 
" 1 If the specified name matches more than one 

name for the given number of characters; 

selects the first of the names 
=" 2 If the specified name does not match any name; 

the name re-.^rence is cleared 
« 3 If no TUTOR file or code file is attached 

(With tags "nextname** and **backname", "zreturn" can have only 
values 2, or 3*) 



getname stores the name currently selected and the associated information, 
if specified; name is left-justified and unused character positions 
are filled with octal zeros 

getname VAR FOR STORING NAME, VAR FOR STORING INFORMATION (opt) 

format for the information (counting from the left end of 
the variable): 

42 bits (7 characters): block type (left-justified) 

access, binary, charset, common, leslist, llneset, 
listing, micro, source, text, vocab 

6 bits (1 character): condense flag [("-" (o46) or " " (o55)] 

3 bits unused 

9 bits: block position in directory 

Note: If no name h^^s been selected, a value of 0 is stored for both 
th*^ name and the information. 
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names atores names of blocks in the file (lef t-justlf leltT with octal zeros 
in unused character positions); each entry requires 2 variables, the 
first for the name and the second for the associated information 

names ARGl (opt ) , ARG2 ,ARG3 ,ARG4 

ARGl « starting postion in the directory of block names 
(numbering starts at 1 for block 1-b) 
(ootional; if omitted, starting position is the name 
currently selected by -setname- or the beginning. of 
the list if no name is selected) 

ARG2 « starting variable for storing names 

ARG3 » maximum number of variables for storing names (each 
requires 2 variables) 

ARG4 « variable for storing actual number of names obtained 

format for the associated information (counting from the 
left end of the variable): 

6 bits (1 character): condense flag ["-" (o46) or " " (o55)] 
6 bits (1 character): blank (o55) 
12 bits (2 characters): block t 
" " (o5555) (source) 
"ac" (00103) (access list) 
"bi" (00211) (binary) 
"ch" (00310)^ (charset) 
"cm" (00315) (common) 

"vc" (o2603) (vocab) 
27 bits unused (o000000000) 
9 bits: number of words of disk space used p 

Note: zreturn " -1 if names are stored successfully 

« 0 if no TUTOR file or code file is attached 
« +1 if the starting position is invalid 



"11" 


(oUil) 


(listing:* 


"11" 


(ol414) 


(lesllst) 


"In" 


(ol416) 


(llneset) 


"M" 


(ol511) 


(micro) 


"tx" 


(o2430) 


(text) 



iospecs specifies parameters for subsequent -getline- commands 
iospecs OPTIONl,OPTION2,OPTION3 
OPTIONS include: 

mods mod words are included in the lines read 

nomods mod words are not included in the lines read 

deleted deleted lines are included in the lines read 
nodeleted deleted lines are not included in the lines read 
truncate the line is truncated if it is too* long for the buffer; 

the line pointer moves to the next line 
notruncate the line is truncated if it is too long for the buffer; 

the line pointer stays at the truncated line 

Note: If the -iospecs- command Is omitted, the default options are: 
nomods , nodeleted , t runcate 
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getllne reads a line from the selected block name in the attached file and 
stores it (left-justified) in the specified variables 

getline ARGl ,ARG2 ,ARG3 

ARGl « starting variable of the buffer for storing the line 
ARG2 « number of variables in the buffer 

ARG3 « variable for storing the number of variables actually 
required to store the line 

Results depend on options set by previous -iospecs-: 

mods \2cd words are stored in the first 2 variables of the 

buffer 

nomods mod words are not stored 

deleted deleted lines are stored 
nodeleted deleted lines are not stored 

truncate a line which is too long for the buffer is truncated, and 
the truncated line is stored; all lines end with 12 bits 
of 0 (o0000); return length is the number of variables 
actually used to store the line 

notruncate a line which iu too long for the buffer is truncated and 
stored (but the next -getline- command will attempt to 
store this line without, truncation); lines so truncated 
will not end in 12 bits of 0; return length is the true 
length of the line, i.e., the number of variables that 
would be required to store it without truncation 



Note: zreturn " -1 

- 0 

- 1 

- 2 

- 3 

- 4 

1 5 



if -getline- is executed successfully 

if no TUTOR file or code file is attached 

if there are no lines left in the selected blocks 

if the line length is greater than the buffer 

length (the line is truncated) 

if this line is a deleted line 

if this line is a .truncated deleted line 

if a system disk error has occurred 



setline sets the pointer for the line to be read by the next -getline- 
command; should be used in conjunction with "zline" 

setline VAR CONTAINING VALUE OF DESIRED "zline" 

Note: zreturn -1 if -setline- is executed successfully 

« 0 if no TUTOR file or code file is attached 
« -fl if the pointer value is illegal 
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parse analyzes (or parses) a line of TUTOR code stored in a buffer 




parse ARGl , ARG2 , ARG3 , ARG4 ,ARG5 ,ARG6 

ARGl ■ starting variable containing the line of code 
ARG2 number of variables to examine (end of line also 

terminates the search) 
ARG3 « variable for storing indent level of code 

(« 0 if not indented) 
ARG4 «* variable for storing the command name, lef t-justlf led 

and filled to character position 8 with spaces (o55); 

if the line is a comment, tKe first 8 characters of 

the line are stored 
ARG5 « variable for storing the relative character position 

of the beginning of the tag 
ARG6 =» variable for storing the number of variables actually 

required to store this line 

Note: zretu^n « -I if the line is a comment or a, deleted line 
* 0 otherwise 
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System variables for file operations 



These system variables are set when the approplate file Is attached or when a 
name has been selected (In the attachei-JWtmeset or group file). 



zcheck current checkpointing status of records 

* -I If checkpointing Is allowed 

« 0 lf"-checkpt off- Is in effect 

* I. if -records save- is In effect 

«• 2 If -abort record- or -abort autocheck- is in effect 

« 3 If the user Is an author or a multiple 

zfacc « -I If the file Is attached read/write 

«• {) If the file Is attached read only or If no file Is attached 



zf lie • name of the file currently attached to the lesson 
(left-justified; display with -shows-) 

zf type type of file which is attached to the lesson ( 'dataset' , 'nameset* , 
•group*, 'lesson', 'code') (left-justified; display with -shows-) 



^^fusers number of users connected to the file currently attached 



zinfo contains the 24 bits of Information associated with the currently 

selected name in a nameset or group; stored in the right-most 24 bits 



zllne value of the pointer to the next line to be read by -getllne- 

znlndex position of the currently selected name in the nameset or group 

directory (■ 0 if no name has been selected or if no nameset or group 
is attached) 



znscpn number of characters per aame for the attached file 

(- 10 for TUTOR file and code file; « 18 for group file) 



znsmaxn maximum number of names (or blocks) allowed in the attached file 
znsmaxr maximum number of records (or blocks) allowed in the attached file 



znsnams 



number of names in use in the attached nameset or group 



znsrecs number of records In use In the entire attached nameset or group 



zrecs number of records In the selected name In the attached nameset or 
number' of extra records (l»e., records added with -addrecs-) In the 
selected name in the attached gro;xp o£ 
number of records In the attached dataset 

zroff * -1 If the currently selected name In a group has been turned off 

- 0 otherwise 

zrstatn station number where the currently selected name In a group Is signed 
on (« -1 if the name Is not signed on) 

zrtype ' user type of currently selected name In the attached group: 
•student", 'multiple* , 'Instructor' , 'author' , 'data* 
(left- just If led; display with -showa-) 

4 

zrvars maximum number of router variables (currently 64) 

zrvret ^ -1 If router variables are permanently stored on disk 

- 0 If router variables are not permanently stored 



zsvars 



maximum number of student variables (currently 150) 



zsvret =- "1 If student variables are permanently stored on disk 
« 0 If student variables are not permanently stored 

zwpb number of computer words per block In the attached TUTOR file or 
code file (currently 320) 

zwpr number of computer words per record In the attached file 
(- 320 for TUTOR file and code file; - 64 for group file) 

zxfile contains the name of the file through which a processor lesson is 
ac^essed (- 0 if the processor lesson is entered directly) 
(left-justified; display with -showa-) 



JUDGING 



Two^ types of commands are described in this section: judging commands and 
regular commands. (Other sections of this book include only regular commands.) 
Regular command's are not executed during the judging process, i.e., after the 
user has entered a response^ nor are judging commands executed before th>i user 
has entered a response or in situations where no response is involved. 
(See "The TUTOR Language" and lesson "aids" for extensive descriptions of the 
judging process.) 

Regular commands in this section Include: -eraseu-, -force-, -edit-, 
"arrow-, -arrowa-, -arheada-, -long-, -jkey-, -copy-, -endarrow-, -getword-, 
-getmark-, -getloc-, -compare-, -1 arrow-, -1 arrowa-, -judge-, -okword-, -noword-, 
^markup-, -markupy-. Commands -list-, -endings-, -vocabs-, -vocab- are special 
non-executable commands which establish lists of words for use with certain 
response-matching commands. The -join- qommand is both regular and judging. 
The remaining commands in this, section are judging commands. 



Preparation for responding 



eraseu (regular command) the specified unit is executed at all subsequent 
arrows in the unit containing -eraseu- when the user erases part or 
all of a response after receiving judgment; useful for erasing 
complicated displays which are not handled by the standard judging 
process 

eraseu UNIT NAME 

* eraseu (B) or eraseu q (clears -eraseu- setting for remainder 

of the unit) 

eraseu EXPR,NAMEM,NAME0,q,NAME2 ,x (example of conditional form; 
maximum of 100 arguments in the conditional tag) 



force (regular command) alters the input of a response as specified; 
setting is cleared at each main unit 

force bold (forces the response to he written in bold characters 

[programmable termin£l only]) 
force caps (Inserts the shift code (o70) before each letter 

(a through z] in the response) 
force first erase (erases an incorrect response and contingent 

message when the user presses any key, not ^ust NEXT, 

ERASE, etc.) 

force font (Inserts the font code (o75) before the first keypress) 
force left (forces the response to be written from right to left) 
force long (initiates judging when the character input reaches 

the value of the tag of -long-; unnecessary with -long 1-) 
force micro (forces keypresses through the microtable conversion) 
force (B) oir force clear (clears previous -force- settings 

in the unit) 
force clear,font,lef t .(may ^omblne tags) 
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edit (regular command) required for EDIT key to be active when, the tag . 

of -long- exceeds 150; specifies the starting variable of a buffer i 
for storing the characters in a response (up to 300 characters) 

edit STARTING VAR (use stuJent variable) 

edit (B) (clears edit buffer; if placed after -arrow-, prevents 
use of the EDIT key; see also -inhibit edit-) 



arrow 



(regular command) plots the response arrow at the specified screen 
location (see -inhibit arrow-); sets defaults: -long 150- and 
-jkey (B)- 



arrow COARSE 
arrow FINEX,FINEY 



arrowa (regular command) allows an alternative arrow associated with -iarrowa- 
and -arheada-; follows same rules and restrictions as -arrow- 

arrowa COARSE 
arrowa FINEX,riNEY 



arheada (regular command) specifies a symbol to be plotted with the 
alternative arrow 

arheada SYMBOL TO BE PLOTTED WITH -arrowa- 

Note: Up to five 6-bit characters may be specified. 



long (regular command) sets the maximum number of characters in a response 
default is 150 characters); must follow -arrow- (see NOTE) 

long NUM CHARACTERS (value of tag is from 0 co 300; -long 1- 
causes automatic judging; tag > 150 requires use of 
-edit- fbr EDIT key to be active; --long 0- prevents 
input from the keyset except for function keys) 



jkey (regular command) specifies the function key(s) which will initiate 

judging (in addition to the NEXT key); must follow -arrow-- (see NOTE) 

jkey KEYNAME (name of function key is in lower case) 
jkey KEYNAME! ,KEYNAME2 ,KFYNAME3 , . . . 

jkey (B) (clears previous -jkey- settings so that only NEXT 
initiates judging) 
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copy (regular command) specifies the starting variable of the character 

string which is to be copied on the screen at the arrow, one. word at 
a time, when the COPY key is pressed; the end of the character string 
is indicated by the specified number of characters or by 12 bits equal 
to 0 (00000), whichever is attained first; loads the string exactly as 
it appears on the screen into the response buffer; must follow -arrow- 
. (see NOTE) 

copy STARTING VAK,NUM CHARACTERS (use student variable) 

NOTE: To affect the first response, -long-, -jkey-, and -copy- must follow the 
-arpow- command but must precede any judging commands • However, aftev^ 
the user enters a response (e.g., an incorrect response), these commands 
can be executed among the regular comma^nds following the matched 
. response in order to affect the next response at .the same arrow. ^ 

endarrow (regular command) (no tag) terminates judging' with an unanticipated 
"no" judgment if the response has not been matched; after an "ok" 
judgment, -endarrow- terminates the search for additional -arrow- 
commands and switches back to the pre-arrow state 
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Vocabulary lists 

list (non-executable) sets up a list of synonyms for judging; used with 

-answer-, -wrong-, -answerc-, -wrongc-, -answera-, -wronga-, -match- 
list LISTNAMEjWORDl ,PHRASE*CONSISTING*OF*SEVERAL*WORDS , 

WORD2,WORD3, (maximum of 7 characters in LISTNAME) 



endings (non-executable) used with -vocabs- and -vocab- to add endings to 
root words (must precede -vocabs- or -vocab-) 

endings NUMBER, ENDINGl, ENDING2, ... (NUMBER is an integeir from 0 to 9) 

Note: In -vocabs- or -vocab-, 

WORD/NUMBER adds endings to the root word and includes all 

words in the vocabulary 
WORD//NUMBER adds only words with endings to the vocabulary; 

the^ root word is not included 
Up to 10 -endings- commands with up to 8 endings each may 
be included. Apostrophe is legal in an ending. 



vocabs (non-executable) sets up lists of ignorable words and synonymous 
required words; used with -concept- and -miscon-j checks for 
capitalization and spelling; allows assignment of user information 
numbers 

vocabs NAME 

< IGNORABLE WORDS SEPARATEDJBY COMMAS> 
WORDl , W0RD2 , PmASE*CONSlSTING*OF*SEVER^^^ 
(SYNONYMOUS W0RDS3 AND PHRASES SEPARATED BY COMMAS) 
(WORD4/s,WORD5/ENDINGl/ENDING2,WORD6//ENDINGl) 
W0RD7/NUMBER1 ,W0RD8//NUMBER2 
(WORD9,WORD10«1,WORD11»2,SYNONYM11=2,...) 

vocab (non-executable) similar to --vocabs- except does not check for 
capitalization and spelling and does not allow phrases 

vocab NAME 

< IGNORABLE WORDS SEPARATED BY COMMAS> 
WORDl, W0RD2 

(SYNONYMOUS WORDS 3 SEPARATED BY COMMAS) 
(WORD4/s,WORD5/ENDINGl/ENDING2,WORD6//ENDINGl) 
W0RD7/NUMBER1 , WORDS //NUMBER2 



ERLC 



NOTE: Up to 7 characters are permitted in the name of the vocabulary. 

' When sets of endings are used repeatedly, -endings- plus -vocab(s)- 
may be more convenient than -vocab(s)- with actual endings included. 
With -vocabs-, user information numbers may have values from 1 to 511, 
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Modification of judging copy of response 

bump removes the specified characters from the judging copy of the 
response before judging 

bump CHARACTERS (maximum of 8 characters; use additional 

-bump- commands for more than 8 characters) 



put replaces a character string in the judging copy of the response 

with another character string 

put STRING1-STRING2 (replaces STRINGl with SJRING^r^^ 



putd similar to -put- but uses th^ first character in the tag as the 
* separator between strings 



putd /STRING1/STRING2/ 
putd , STRINGl ,STRING2 , 



(separator is /) 
(separator is ,) 



putv similar to -put- but works with stored strings 

putv ARGl , ARG2 , ARG3 , ARG4 

ARGl ■ starting variable of string (left-justified) 

ARG2 •* number of characters in snring 

ARG3 » starting variable of replacement string (left-justified) 

ARG4 number of characters in replacement^ string 

NOTE: Maximum number of characters in a string cov -put-, -putd-, and -putv- 

is 50« If replacement operations cause t^e judging copy of the response 

T""' 

close tak^s characters stored in the right-most six bits from successive 
variables and makes a judging copy for use with judging commands; 
often paired with -open-; the end of the character string is 
indicated by the specified number of characters or by six bits 
equal to zero (o00) , whichever is attained first 

close STARTING VAR,NUM CHARACTERS (use n-variables) 



ERLC 



loada takes the characters stored in the specified variable(L) by -pack-, 

-storea-, or -calc- and makes a judging copy; the end of the 

character string is indicated by the specified number of characters 

or by six bits equal to zero, (o00), whichever is attained first 

load^ STARTING VAR,NUM CHARACTERS (opt) (number of characters, 
if omitted, is 10; maximum number of characters is 299) 
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Modification of judging procedure 



ERIC 



NOTE: The various -specs- options do not affect all judging ccmmands. 

Commands affected by each -specs- option are indicated by number 
from the following list. 

judging commands affected by -specs- 

1« -match- 

2* -answer-, -wrong-, -answerc-, -wrongc-, -answer a-, -wronga-- 

3. -vocabs--, -concept-, -miscon- 

4. -vocab-, -concept-, -miscon- 

5. -exact-, -exactc-, -exactv- 

6. -ansv-, -wrongv-, -ansu-, -wrongu-, -store-, -storeu- 
1. -storen- 

8» -storea- 

specs allows control over processing of responses; also serves as a marker 

for execution of subsequent regular commands after judging is complete 

snecs allwords (treats integers like letters [rather than numbers] 

so that a number-letter boundary is not like a 
word-word boundary or punctuation) 
(with 1, 2, 3, 4, 7 above) 

specs alphxnum (treats a letter-number boundary like a word-word 

boundary or like punctuation) 
(with 1, 2, 3, 4, 7 above) 

specs bumpshift (removes shift codes from the judging copy of the 

response) 
(with all commands above) 

specs exorder (checks the order of ignorable words) 
(with 2 above) 

/ 

specs holdmark (prevents markup of the respons^e but stores the 

markup information for later display) 
(with all commands above where markup is done: 2, 3, 4) 

specs nodiff (turns off the numeric difference judger, which 

tr-iats a numerical response as a "misspelling" if 
it is within 10% of the correct response; 
no spelling markup is done) 
(with 2 above) 

specs nomark (turns off answer markup) 

(with all commands above where markup is done: 2, 3, 4) 

specs nookno (prevents appearance of "ok" and "no") 

(with all commands above) 
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specs noops (prevents use of mathematical operations in a 

numerical response) 
(with 6 above) 

specs noorder (turns off the order judger; allows any word order; 

no order or missing-word markup is done) 
(with 2, 3, 4 above) 

specs nospell (turns off the spelling judger; no spelling markup 

is done) 
(with 2 above) 

specs novars (prevents use of variables defined in define set 

"student") 
(with 6\ above) 

specs okassign (allows assignment of a value to a variable defined 

in define set "student") 
(with 6 above) 

8(pecs okcap (allows a capitalized word in the response to 

match a non-capitalized word in the tag of a 
response-matching command or in the vocabulary) 
(with 1, 2, 3 above) 

specs okextra (allows extra words in the response; caution — 

words not In -vocabs- may be treated as spelling 
errors) 
(with 2, 3, 4 above) 

specs okspell (allows any reasonable spelling) 
(with 1, 2, 3 above) 

specs toler (allows 1% tolerance in a numerical response) 

(with 1, 2 above) . ^ 

specs (B) (acts only as a marker) 

spec^ nookno, okspell, noorder (may combine tags) ' 

Note: The following system variables are set properly even if 
use of the -specs- tag causes the response to match the 
tag of a response-matching command* 

-specs- tag system variable 
okspell spell 
okcap capital 
okextra extra 
noorder order 
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Storing judging copy of response 




NOTE; Commands -store-, -storeu-, and -storen- terminate judging with a 
"no" judgment If an error is found in the form of the response. 



store calculates the numerical value of the response and stores it in 
the variable specified in the tag 

store VAR 



storeu similar to -store- but also evaluates dimensionality of units 



/ 



storeu VAR FOR STORING NUMBER, STARTING VAR FOR STORING POWERS 

OF DIMENSIONS (see -define-: units; use v-variables to 
store the powers of the dimensions; powers are stored 
in the order in which the primary units are defined) 



storen searches for and evaluates simple numerical expressions (without 
varia^es) in the response, which may also contain non-numeric 
characteb^; stores numerical results in the specified ^«H6iafclig^one . 
at ,a time; removes numerical parts of the response from the answer 
buffer and replaces them with spaces; numerical parts must be set off 
from letters by spaces or punctuation; if no numerical expression is 

I found, the variables are set to 0 and judging ends with a "no" 

judgment; each -storen- increments "anscnt" \ 

storen VARl , 
storen VAR2 



storea stores characters from the response, left-justified, in the specified 
variable(s), 10 characters per variable; unused character {.^sitiohs 
are filled with octal zeros 

storea STARTING VAR,NUM CHARACTERS (opt) (number of characters, 

if omitted, is 10) 

Note; Use n-variable(s) for storing the string if subsequent 

comparison for equality with another string is done* (If the 
character string is stored for other purposes, v-variables are 
acceptable.) Segmented variables cannot be used with -storea-* 

open places the characters in the response, one-by-one, in the right-most 
six bits of successive variables starting at the specified variable 




open STARTING VAR (use n-varlables) 
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Matching judging copy of response 



NOTE: References to response mean judging copy of the response • Except for 
-match-, judging terminates when the response matches the tag. The 
-match- command always terminates judging • 



, NOTE: Up to 3? "words" (entries separated by space or punctuation) are 

permitted in responses with -match-, -answer-, -wrong-, -answer c-, 
-wrongc-, -answera-, -wronga-, -concept-, and -miscon-. If the number 
of words exceeds 39, jiidgment is "no" and "anscnt" is set to -2. 
With these commands the tag may not contain punctuation (or symbols 
changed to "punc" by the -change- command) although the user's response 
may contain punctuation* 

(See "judging values" in "aids" for details on punctuation.) 

Response markup (refer to -specs- for identification of commands with 
which the markup is used): 
mmtm word ±3 misspclled (2, 3) 

word is capitalized incorrectly (2, 3) . 
*** word is part of a broken phrase (2, 3) 

word is out of order (too far right) (2) 
A word is missing (2) 
XXX word is an extra word (2) 

uuu word is an extra word (not in vocabulary) (3, 4) 



checks the response against the arguments in the tag and sets a 
variable to the relative position of the matched character string; 
removes the matched string from the answer buffer and replaces it 
with spaces; if no match is found, the variable is set to -1 and 
judgment is "no" (sets "judged" to +1); othe'^ .ri.se judgment is "ok" 
(sets "judged" to -1) 

match -VAR,WORD0 ,W0RD1 , PHRASE*W0RD2 , W0RD3 

match VAR, ( WORD0 ,SYNONYM0) , ( WORDl , (LIS7NAME1 ) ) , ( (LISTNAME2) ) 

compares the response with the tag; checks for word order, spelling, 
capitalization, extra words, and numeric tolerance unless altered 
by -specs-; setS/ /Judged" to -1 if the response matches the tag 

answer WORDS AND PHRASE*WORDS (blank tag matches a response which 

is blank or which contains only spaces and pxmctuation) 
answer <EXTRA WORDSX SYNONYMOUS WORDSI AND PflRASE*WORDSl 

SEPARATED BY COMAS) (SYNONYMOUS W0RDS2 and PHRASE*W0RDS2 
SEPARATED BY C(»IMAS)W0RD3 
answer «LISTNAME1»((LISTNAME2))((LISTNAME3) ,W0RD3). 
answer RESP0NSEl;RESF0NSE2;RESP0NSE3 (each argument may have any 

of the preceding forms for the tag of -answer-; synonymous 
responses for the same argument are separated by commas) 



match 



answer 
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Wrong same options as -answer- but for an Incorrect response; sets 
"judged" to 0 if the response matches the tag 



wrong WORDS AND PHRASE*WORDS * 



answer" compares the response with one of several arguments In the tag, 
depending on the rounded value 9f the conditional expression; 
performs the checks available with -an wer-; sets "judged" to -1 
if the response matches the required argument 

answerc EXPR^RESPONSEm|rESPONSE0^^RESPONSE2 (the arguments may 
have any of the forms allowed in the tag of -answer-; 
a blank argument indicates no anticipated response for 
that value cf the conditional expression) 



wrongc same options as -answerc- but for an incorrect response; sets 
"judged" to 0 if the response matches the required argument 

wrongc EXPR^RESPONSEm||^RESPONSE2^RESPONSE3 



answera same options as -answer- except the tag is variable (the stored 

character string consists of a tag which is allowed with -answer-); 
the end of the character string is indicated by the specified number 
of characters or by six bits equal to zero (o00), whichever is 
^>ttalned first; sets "judged" to -1 if the response matches th^ tag 

answera STARTING VAR OF STORED STRING, NUM CHARACTERS (opt) 
(NUM CHARACTERS, if. omitted, is 10) 



wronga same options as -answera- but for an incorrect response; sets 
"judged" to 0 if the response matches the tag 

wronga STARTING VAR OF STORED STRING, NUM CHARACTERS (opt) 



concept, compares the response with the tag; -vocab- or -vocabs- provides 
synonyms; sets "judged" to -1 if the response matches the tag 

concept WORDS AND PHRASE WORDS (no asterisk in phrases; blank tag 
matches a response which is blank or which contains only 
ignorable words from the vocabulary) 

concept WORDl W0RD2,VAR14 WORDl ,VAR2« W0RD2 (detects which synonym 
is entered if the vocabulary is appropriately set up) 




miscon same options as -concept- but for an incorrect response; sets 
"judged" to 0 if the response matches the tag 

miscon WORDS AND PHRASE WORDS 
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exact compares the response with the tag for an exact character string 
match; sets "judged** to -^1 If the response matches the tag 

exact STRING (blank tag matches a blank response) 



exactc compares the response for an exact character s'tri g match with one 
of several arguments in the tag depending on the rounded value of a 
conditional expression; sets "judged!' to -1 if the response matches 
the reqtiired argument 

exactc EXPR,STRINGM,STRING0,,STRING2 (blank argument matches a 

blank response) 



exactv compares the response with a stored character string for an exact 

match; the end of the character string is indicated by the specified 
number of characters or by six bits equal to zero (o00), whichever is 
attained first; sets "judged" to -1 If the response matches the tag 

exactv STARTING VAR OF STORED STRING, NUM CHARACTERS (opt) 

(NUM CHARACTERS, if omitted, is 10; if the number of 
, * characters is 0, the response is judged correct if nothing 

is entered) 

\ 

NOTE: With the following four commands (-ansv-, -wrongv-, -ansu-, -wrongu-). 

TOLERANCE is optional* When tolerance is omitted, the default is 10"^ 
if the absolute value of the tag value is less than approximately 100 
or (10"^^ X I tag value I) if the absolute value of the tag value is 
greater than approximately 100* These commands caanot judge values 
smaller In absolute value than 10*"^ since any response less than 10"^ 
will then match the tag» 

TOLERANCE may be absolute deviation or percent deviation^ 



ansv checks a numerical response against the first argument in the tag, 
with tolerance, if given, set by^the second argument; sets 
"judged" to -1 if the response matches the tag (within the tolerance) 

ansv CORRECT VALUE , TOLERANCE 



wrcngv similar to -ansv- but for an incorrect numerical response; sets 

"judged" to 0 if the response matches the tag (within the tolerance) 



wrongv INCORRECT VALUE, TOLERANCE 
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ansu similar to -ansv- but checks for correct units; sets "judged" to -1 
if the response matches the tag (within the tolerance) 

ansu NUMBER AND UNITS , TOLERANCE 

wrongu similar to -ansu- but for an incorrect response; sets "judged" to 0 
if the response matches the tag (withir the tolerance) 

wrongu NUMBER AND UN ITS, TOLERANCE 

wrongu NUMBER, TOLERANCE (may be used to indicate that units 

are missing) 

NOTE: For applications of -ansu- and -wrongu- see -storeu- and -define-. 

Commands -ansv- and -wrongv- accept defined units in the user's response 
but they do not judge the units. 

touch specifies the location of a rectangle for a touch response; sets 

"judged" to -1 if the specified rectangle is touched (see -enable- 
and -disable-) 

touch AREA1;AREA2;AREA3; ... (blank tag Hatches any touch input) 

Note: AREA may be: COARSE, WIDTH IN CHARACTERS, HEIGHT IN LINES 
or FINEX,FINEY, WIDTH IN DOTS, HEIGHT IN DOTS 
COARSE or FINEX,FINEY is the screen location of the lower 
left corner of a rectangle of specified width^and height. 
Width and height are optional and assumed to be 1 if omitted. 

-touchw -same-options- ^s -touch-. but_^or an Incorrect touch response; sets 
"judged" to 0 if the specified rectangle is touched 

touchw AREAl ; AREA2 ; AREA3 ; AREA4 ; . . . 

NOTE: One touch square is 32 dots on each side (or 4 cnaracters in width 
and 2 lines in height). 

or (no tag) placed on the line between resp-^nse-matching commands 

to provide alternative responses for the same value of "anscnt" 

ans (no tag) allows use of the ANS key; terminates judging only if 

ANS is pressed; otherwise normal judging occurs; -ans- must be 
the first judging comilismd following the -arrow- command unless 
-jkey ans- is in effect 



7n 
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Information on specific words in response 

NOTE: In the following commands (-getwordT, -getmark-, -getloc-, -compare-), 
a "word" is an entry set off by spaces or punctuation from surrounding 
characters. (See -specs allwords-, -specs -alphxnum- and 
-change symbol- for addj....ional options in specifying word boundaries.) 

gietword (regular command) allows storage of individual words in a response 
getword ARG1,ARG2,ARG3,ARG4 (opt) 

ARGl « relative position of the word in the response 

(first word is 1, second word, 2, etc.) 
ARG2 « starting variable for storing the word (up to 

10 characters per variable) 
ARG3 « variable for storing the actual number of characters 

in the word (- 0 if ARGl > "wcount") 
ARG4 « maximum number of characters to be stored in ARG2 

(optional; if c. tted, value- is 10) 

Note: Words that are stored are not removed from the judge buffer. 

getmark (regular command) useS after judging a response to give markup 
information on individual words in the response 

getmark ARG1,ARG2 

ARGl « relative position of the word in the response 

(first word is 1, second word, 2, etc.) 
ARG2 « variable containing markup information 

« -2 if the response is perfect or if no markup is done 

with the response-matching command used 
» -1 if the position of the word is out of bounds 

(i.e., if ARGl > "wcount") 
« 0 if there are no errors in the word 
> 0 bits in ARG2 are set according to the error (s), 
starting at the right-most bit (subscript "2** 
indicates the number is in binary notation): 
(I2) a word preceding this word is missing 
(102) the word is out of ordar (too far right) 
(1002) there is a capitalization error 
(1 0002) the spelling is incorrect 
(10 0002) the word is part of a broken phrase 
(100 0002) the word is an extra word 
(1 000 0002) this word is the last word, and a 

word which should follow is missing 



so 
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getloc (regular command) gives the screen position of the beginning (and 
end, if requested) of the specified word in the response 

getloc ARG1,ARG2,ARG3,ARG4 (opt),ARG5 (opt) 

ARGl " relative position of the word in the response 

(first word is 1, second word, 2, etc.) 
ARG2 " variable for storing the finex screen position of 

nhe beginning of the word (- -1 if ARGl > "wcount") 
ARG3 « variable for storing the finey screen position of 

the beginning of the word 
ARG4 » variable for storing the finex screen oosition of 

the end of the word (optional) / 
ARG5 « variable for storing the finey screen position of 

the end of the word (optional) / 

I 

compare (regular command) compares two words for spellir^g 
compare ARGI,ARG2,ARG3 

ARGl » starting variable containing a word 

ARG2 « starting variable containing another word 

ARG3 =* variable for storing the result code 



result « -1 if the words are different 
■ 0 if the words are identical 
> 0 if the words are misspellings of each other 
(smaller value indicates a closer match) 



Note: The words must be stored in the same manner, e.g., both words 
left-justified or both right- justified. Words stored with 
-storea- or -pack- are left-justified. 
If a word itself is given (^ 10 characters), it muift be 
enclo3ed in single quotes for left-justification or double 
quotes for right-justification. 

System variables "spell" and "capital" are set if result 
value ^ 0: 

"capital" is set to 0 and "spell" is set to -1 if only one 
word is capitalized but spellings are identical; 
otherwise "spell" is set to 0 if result > 0 

The end of each word is marked by a punctuation symbol, space, 
or 6 bits of 0 (o00). Word*^ are compared up to the first 
occurrence of a terminating symbol. 

A maximum of 39 characters in each word may be compared. 
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Unconditional juagment 

ok (no tag) judges any response "ok"; sets "judged" to -I 

no (no tag) judges any response "no"; a^ets "judged*' to +1 

ignore (no tag) erases and ignores any response; stops further 
processing and waits for a new response . 

K 
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Reference to other units which may contain judging commands 



join causes execution of the specified unit without change of main 

unit; commands following -join- are executed; -join- is executed 
in all states: regular, judging, and f earch (see also description 
under SEQUENCING, Automatic sequencing) 

join UNIT NAME 

join NAME, VAR<$« INITIAL EXPR, FINAL EXPR,STEPSIZE EXPR (opt) 
join EXPR,NAMEM,NAl4E0,x,NAME2,q (example of conditional form) 



iarrow. (regular command) the specified unit is executed after each 

^ subsequent -arrow- in a unit just before the first judging command 
is executed 

iarrow UNIT NAl^ 

iarrow (B) or iarrow q (clears the -iarrow- setting for 
subsequent -arrow- commands in the unit) 

iarrow EXPR,NAMEM,NAME0,q,NAME2,x (example of conditional form; 
maximum of 100 arguments in the conditional tag) 

Note: The -iarrow- setting is equivalent to -join- after each 

subsequent -arrow- (just before the first judging command); 
the specified unit is executed in all states. 

iarrowa (regular command) similar to -iarrow- but is associ2*;ed with 
-arrowa-; see -iarrow- for restrictions 

iarrowa UNIT NAME 



Do 



Alteration of judgment 
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judge (regular command) alters the judgment rendered by judging commands 



judge 
judge 

judge 

judge 

r 

judge 
judge 



judge< 
judge 



judge 
judge 



ok 



no 



wrong 
okqui t 
noqui t 
quit 



judge ignore 



exit 

continue 



rejudge 
EXPR,x,no 



(setp judgment to "ok"; sets "judged" to -1; 
continues executing regular commands) 
(sets judgment to "no" [unanticipated]; sets 
"judged" to+1; continues executing rjfegular 
commands) ' 
(sets judgment to "no" [anticipated]; sets 
"judged" to 0; continues executing regular 
commands) 

(sets judgment to "ok"; sets "judged" to -1; 
terminates, execution at that arrow except for 
regular commands following -specs-) 
(sets judgment to "no"; sets "judged" to +1; 
terminates execution at that arrow except for 
regular commands following -specs-) 
(leaA^es judgment unchanged and terminates 
execution at that arrow except for regular 
commands following -specs-; allows the user to 
proceed to the next arrow even if judgment on 
the current arrow is "no") 
(stops executing all commands, erases the 
response, and waits for a new response) 
(rescinds judgment and waits for additional keys) 
(resumes judging using the modified response, 
as altered by -bump-, -put-, -specs-, -match-, 
-storen-, etc#; resumes executing judging 
commands) \ 
resumes judging using the original, unmodified \ 
response and clears the -specs- setting; \ 
resumes ex6cuting judging commands) 
,ignore,ok (example of conditional form; 

argument x leaves judgment unchanged) 



-5 
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Alteration of feedback 



okword (regular command) permits "ok" message to be changed 

okword NEW WORD FOR USE WITH "OK" JUDGMENT (may be blank) 

noword (regular command) permits "no" message to be changed 

noword NEW WORD FOR USE WITH "NO" JUDGMENT (may be blank) 



NOTE: Tags of -okword- and -noword- may* have up to 9 characters • 
^ A space is automatically provided before the message. 

Commands -okword- and/or -noword- may be placed anywhere in the 
\ lesson. Once they are executed, they are in effect until execution 

of another -okword- and/or -noword- command. 



markup 



markupy 



(regular command) (no tag) used with -specs holdmark- to display 
markup information that was inhibited with -specs holdmark- 

J 

(regular command) specifies vertical displacement of markup 
information in screen dots from the default posiuion of 8 dots below 
the response; tag is negative for new position below the default, 
positive for above; new position is in effect until execution of 
another -markupy- command 

markupy DOTS FROM DEFAULT MARKUP POSITION 

markupy 0 (sets to default position of 8 dots below rt>sponse) 



ERLC 
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Sy tem variables for judging 

Judging In general 
* » 

anscnt number of response-matching commands encountered at an ^rrow 



before the response Is matched; also set by -storen-; otherwise, 
« -2 If the user's response contains more than 39 words 
» |-1 If no tag Is matched 
»y 0 for a store error 

aferoed for each -arrow- and each -specs- command 



* pnsok * -1 If the response Is a satisfactory match to the preceding 



response-matching command 
» 0 otherwise 
in particular, after -no-, 

» -1 if there is no match to a previous response-matching command 
« 0 if the match is poor 



key 

ztouchx [See descriptions under system variables for sequencings] 
ztouchy 

ntrieo number of attempts on the current arrow 
verbal responses 

judging commands which affect system variables for verbal responses: 

1. -match- 3» -vocabs-, -concept-, -miscon- 

2* -answer^-, -wrong-, -answerc-, -wrongc-, 4» -vocab-, -concept-, -miscon- 
-answers-, -wronga- 



capltal « -1 if there are no capitalization errors, 0 otherwise 
(with 1, 2, 3 above) 

entire » -1 if all required words are present, 0 otherwise 



jcount 



rfumber of internal 6-bit character codes in the response 



judged 



» -1 for ally "ck" judgment 

» 0 for any "wrong" judgment (anticipated "no") 

« 1 for any "no" judgment (unantic^^pated "no") 

« 2 for response not yet judged / 




(with 2 above) 
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extra ^1 if there are no extra words in the response, « 0 otherwise 

(with 2, 3, 4 above) 



order » -1 if word order is ok, = 0 otherwise 
(wiv^h 2 above) 

\ 

phrase » -1 there are no phrase errors, =» 0 otherwise 
(with 1, 2, 3 above) 



spell « -1 if spelling is ok, .0 otherwise 
' . (with 1, 2, 3 above) 



vccab = ^1 if all words in the response are In the vocabulary. = 0 otherwls 
(with 3, 4 a'bove) 

wcount number of words in the response (maximum of 39) 
(with all above) 



numerical responses 

These system variables are set with -ansv-, -wrongv-, -ansu-, -rwrongu^, 
-store-, -storeu-, -compute-, -calc-, -calcc-, and -calcs-. 

opcnt number of arithmetic operations and functions in Jthe-response 

(=* -1 if there are no operations and the expression cannot be stored 
with -store-) 

varcnt number of defined variables and functions (ueflne set "student") 
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formok gives diagnostics on errors in mathematical expressions 

«« --I If the expression Is ok 

» 0 If there Is a bad function ^rgument or index 

«" 1 if there is an illegal character 

» 2 if there are unbalanced parentheses 

* 3 if there are too many decimal points 

» 4 if there are variables not defined in define set "student** 

- 5 if a symbol involving $ is not a logical-^ a bit operator 
» 6 if the expression has bad form 

= 7 if a value is assigned .to a non-variable 

« R if an octal constant contains digit 8 or 9 

« 9 if there is an error in an alpha string 

» 10 if a number has too many digits 

-11 If an array index is out of bounds 

- 13 if there are variables with -specs novars- 
«■ 13 if there are operations with -specs noops- 

« 14 if there are assignments without -specs okassign- 

» 15 if u..its in the response are used incorrectly 

16 if too much computing is attempted 

« 17 if the expression is too deep in nested functions 

» 18 if a function has the wrong number of arguments 

- 20 if an array has the incorrect number of arguments 
« 21 if an array is not permitted in this expression 

« 22 if the array size is incorrect or operation is nonconformal 

« 23 if there are too many arrays in the expression 

» 60 if too many temporary variables are needed during processing 

=» 62 if expression is too complicated for temporary storage to hold 

« 63 if there are too many literal numbers in the expression 

« 65 if there is "an error in a segment definition 

= 66 if expression is too deep in indexes which are assij^ned values 
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Cotnmands in this section are legal only In a site lesson. 



Site commands 



These commands, all of which have -site- in the command field, give Information 
on the specified logical site.' 

site set specifies the logical site for subsequent -site- commands 
and -station- commands; a later -site set- command 
overrides an earlier one 

site set, 'SITENAME' 

Note: . zreturn » -1 if -site set- is executed successfully 

« 0 if the lesson is not a site lesson for, the 
specified sltename 



site info stores current site EM information for the site specified 
' by a preceding -site set- 
site info, STARTING VAR FOR STORING INFORMATION 
Note: Information consists of: 

n(x) o£ nc(x) " starting variable 

n(x) contains the base EM allotment 

n(x+.l) " the EM currently allotted 

n(x+2) " the EM currently In use 

n(x+3) " the number of active terminals at the. site 

zreturn -1 if -site Info- is executed successfully 
« 0 if no site has been set by -site set- 



site active stores the physical station numbers of the specified 
number of active stations on the site 

site active, STARTING- STATION NUMBER, STARTING VAR FOR STORING 
STATION NUMBERS, NUM ACTIVh. STATIONS TO STORE 

Note: zreturn » -I if -site active- is executed successfully 
« 0 if no site has been set by -site set- 
a +1 if the starting statibn number is invalid 
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site stations stores the physical station numbers of the specified 

number of stations permanently on the site 

site stations, STARTING STATION NUMBER, STARTING VAR FOR STORING 
I STATION NUMBERS, NUM STATIONS TO STORE 

Note: zreturn ■ -1 if -site stations- is executed successfully 
« 0 if no site has been set by -siiie set- 
« +1 if the starting station number is Invalid 



• 
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Station commands 



These commands, all of which have -station- In the command field, give 
Information on Individual stations on the specified logical site. 




station info stores information on the specified physical station number 
station info, STATION NUMBER, STARTING VAR FOR STORING DATA 
Note: Information consists of: 



n(x) nc(x) 
n(x) and n(x+l) 
n(x+2) contains 
n(x+3) 
n(x+4) 
n(x+5) 

n(x+6) 
n(x+7) 



n(x+8) 
n(x+9) 



z re turn 



= starting variable 

contain the user's name (up to 18 characters) 
the name of the user's group 
the type of user 

the account name containing the user's group 
session statistics (in 3 20-bit fields- 
disk accesses, seconds of CPU, elapsed time in seconds) 
the name of the user's lesson or type of activity 
total EM the lesson is using (in 3 15-blt fields- 
storage EM, common EM, lesson EM [left-most 15-bit 
field is empty] ) 
name of the user's router 

EM used by the router (same format as lesson EM) 

« -1 if -station info- is ex;ecuted successfully 
« f) if no site has been set by -site set- 
s' 1 if the starting station number is invalid 
=* 2 if the specified station is not on the site 
= 3 if tha. station is inactive 



station status sets "zr^eturn" according to the status of the speciCled 
> ^ physical station number 

station status, STATION NUMBER 



Note: zreturn « 



-2 if the station is in the process of signing on 

-1 if the station is active 

0 it no site has been set by -site set- 

1 if the starting station number is invalid 

2 if the specified station is not on the site 

3 if the station is inactive 

4 if a backout of the station is in progress 

5 if the station is locked out 
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station send 



sends the specified message (in -mode rewrite-) to the 
^specified physical station number 



station send, STATION NUMBER, SCREEN LOCATION, MS S SAGE, NUM 
CHARACTERS IN MESSAGE 



Note: zreturn » 



-1 if message is sent successfully 

0 if no site has been set by -site set- 

1 if the starting station number is invalid 

2 if the specified station is not on the site 

3 no message is sent (specified station is a 
runner station or is the station sending the 

• message) 



station logout backs out the station (given by the physical station number) 
(sets "backout" to -2) 



Note: zreturn 



station logout, STATION NUMBER 

-1 if the ba'ckout is successful 

0 if no site has been set by -site set- " 

1 if the starting station number is invalid 

2 if the specified station is nqt on the site 

3 if the specified station cannot be backed out 



station 



stopl presses STOPl at th3 specified station (sets "backout" to 
+1 until the station enters another instructional lesson) 

station stopl , STATION NUMBER 

Note: zreturn -1 if STOPl is pressed at the station 

=» 0 if no site has been set by -site set- 
' a 1 if the starting station number is invalid 
« 2 if the specified station is not on the site 
« 3 if STOPl cannot be pressed at the specified 
statidn 



station off 



turns off the specified station and prevents further use of 
the terminal (sets "backout" to -2) 



station off, STATION NUMBER 



Note: zreturn ^ 



-1 if the station is turned off successfully 

0 if no site has been set by -site set- 

1 if the starting station number is invalid 

2 if the specified station is not. on the site 

3 if che specified station cannot be turned off 
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station on turns on the specified station 



station on, STATION NUMBER 

Note: zreturn • -1 If the station Is turned on successfully 
■ 0 If no site has been set by -site set- 
* • 1 if the starting station number Is Invalid 
» 2 If tiic specified station Is not on the site 
« 3 the statluri Is already active 
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System variables for managing sites 

zlsac " -1 if the lesson is a site access controller 

« 0 otherwise 

zrunner -1 if the lesson is being executed at a runner station 

» 0 otherwise 
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-Basic display , , ^ 

at specifies starting position of display on the screen; sets left margin 

at COARSE 

at FINEX,FINEY \ 

\ 

Note: The following formulas convert between character grid and 
fine grid. ^ 

finex » 800X f rac(coarse/100) - 8 
finey - 512 - 16x int(coarse/100)* 

coarse « H?0x {1 + int[(511 - finey)/16]} + int(finex/8) + 1 



atnm like -^t- but does not reset the left margin 

atnm COARSE 
iftnm FINEX, FINEY 



write displays text on the screen 

write ANY MESSAGE, WHICH MAY CONSIST OF SEVERAL LINES 
AND INCLUDE EMBEDDED INFORMATION. 



writec displays one of several. messages depending on the rounded value of 
the conditional expression 

writec EXPR^MESSAGEM|mESSAGE0^MESSAGE1^JmESSAGE3 

1 

NOTE: The embed feature Is available. See descriptions of the individual 
commaads in this section for information on FORIiATi, MINIiMUM, and 
ASTERISK, which are optional. i 

show,EXPk, FORMAT, MII«MUM> or < s,EXPR, FORMAT, MI NIMUM> 
showz,EXPR: FORMAT > or < z,EXPR, FORMAT > 
showt,EXPR',FORMAT> or < t,EXPR, FORMAT > 

showe,EXPR, FORMAT, Af?T£RISK> or < e,EXPR,FORhAT,ASTERISK> 
6howo,EXPR, FORMATS or <( o ,EXPR, FORMAT > 
showh,EXPR, FORMAT > or <l h,iiXPP, FORMAT > 
fahowa, STARTING VAR,^OR?iAT> or <f a, STARTING VAR,FORMAT> 
at:,COARSE> ; < at,FTNEX,FINEY> 

acnm,COARS?.> ; < atnn,FIM:X,FINEY> * 



(write mode) 
(erase uode) 
(rewrite mode) 



embedded 


-sho;v • 




em Lidded 


-showz- 


< 


embedded 


-showt- 


< 


embedded 


-showe- 


< 


embedded 


-showo- 


< 


embedded 


-showh- 


< 


embedded 


-showa- 


< 


embed ded 


-at- 


< 


embedded 


-atnm- 


< 


embedded 


-size- 


< 
< 


embedded 


-rotate- 








< 


""^^bedded 


-mode- 


< 
< 
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NOTE: In the shfelNtype commands (-show-, -showr-, -showt-, -showe-, -showo-, 
-showh-,/-8howa-) , the general form is 

showz EXPR, FORMAT 

where FORMAT, which may be an expression, is optional. 
If FORMAT equals 0, nothing is displayed. 

For displaying entire arrays, the general form is 

showt ARRAYNAME, FORMAT (for arrays with namber of rows i 16, 

number of columns ^64; -showa-, -showh-, -shovo-, -showe- 
may also be used to display entire arrays) 

To display only the first element of an array, use 

show ARRAYNAME, FORMAT or showz ARRAYNAME, FORMAT 

show displays the value of a variable or an expression with th-^ specified 
number of significant digits but with suppression of triii^iitg zeros 
after the decimal point; exponential /format is displayed if the 

' number of digits preceding the decimal point exceeds FORMAT by 

^ more than 4, or if the absolute value is less than 10**^; 
MINIMUM is between 0 and 1 and specifies the smaller t noii-zero 
value to be displayed (0 is (displayed if the absolute value of 
t\\e expression is less than MINIMUM) 

show ^ EXPR, HUM DIGITS, MINIMUM (FORMi\T, if omitted, is 4; 
MINIMUM, if omitted, is 10"^) 



• 



showz similar to -show- but displays all digits, including trailing zeroe 
showz EXPR,NUhr DIGITS (FORMAT, if omitted, is 4) 



showt displays the value of a variable or an expreusion in the specified 
format 

showt EXPR,NUM DIGITS PRECEDING DECIMAL POINTjNUM DIGITS 
FOLLOWING DECIM^ POINT (may be omitted if zero) 
(FORMAT, if omitted, is 4,3 for v-variable, 8 for 
n-variable; if the number of decimal places is less 
than 10, FORt^T mt*y also be expressed as a single 
decimal number: e.g., 4.3 is enuivalent to 4,3) 




showe displays the value of a variable or an expression in exponential 
foi^it with the specified number ^ot significant digits, including 
a leading blank or a minus sign; an optional third argument 
specifies the format for the exponent 

showe EXPR,NUM DIGITS, ASTERISK (FORMAT, if omitted, is 4; 

^ST'XRISK is omitted or "0 for exponent expressed by 
superscript, for exponent expressed by 2 asterisks and 
multiplication sign replaced by one asterisk) 

, 9C 
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shqwo displays the value of a variable or an expression In octal notation 

showo EXPR,NUM DIGITS DISPLAYED (FORMAT, If omitted. Is 21; 
In embedded -showo- default format lis 20) 



showh displays the value of a variable or an expression in hexadecimal 
notation^ 

showh EXPR,NUM DIGITS DISPLAYED (FORMAT, if omitted. Is 16; 
in embedded -showh- default format is 15) 



showa displays characters in the specified variable(s) or specified string," 
reading from* the left end of the buffer 
« 

showa STARTING VAR,NIftI CHARACTERS (FORMAT, if omitted, Is 10) 
showa 'STRING' (STRING may contain up to 10 characters) 



hidden displays hidden as well as visible characters; (special symbols are 
used to display hidden characters); number of characters Includes 
all 6-blt character codes 

hidden STARTING VAR,NUM CHARACTERS (opt) (NUM CHARACTERS, 

fif omitted, is 10) 

Note: Symbols for hidden characters are: 

o zero code (o00) - blank (o55) u subscript (o66) 

n superscript (o67) t shift (o70) + carriage return (o71) 

4- backspace (o74) ♦ font (o75) ° access (o76) 



text displays contents of an alphanumeric buffer, line by line; the end 
of a line must be indicated by a variable ending with 2 zero codes 
(i.e., 12 bits equal to 0: 00000) (embedded zero codes (o00) are 
Ignored); not affected by -size- or -rotate- 
text STARTING VAR,NUM VARS 



erase erases the screen, selectively or entirely 

erase abort (causes a full-screen erase and aborts output) 
erase (B) or erase NEGATIVE NUMBER (causes full-screen erase 

but does not abort output) 

erase NUM CHARACTERS TO BE ERASED 

erase NUM CHARACTERS PER LINE,NUM LINES (causes block erase) 

Note: Selective erase is affected by preceding -size-, -gorlgln- 
(and -scalex-, -scaley-), and -rorigin-. 



ERIC 



07 



P4 



\ 



mode- ^ specifies terminal writing node (see also system variable "lODde") 

mode write (normal writing state; writes only selected dots) 
mode erase (erases only selected dots) 

mode rewrite (erases and rewrites In one step; does not work 

with "size" 0) 
mode Inverse (only on programmable terminal; displays dark 
' writing on light background) 

mode EXPR, erase, write, X, erase (example of conditional form; 
argument x leaves writing mode unchanged) 

Note: The mode Is reset to "write" after any full-screen erase, In 
particular at a main unit not containing -Inhibit erase-. 



size specifies the size of line-drawn characters; remains In effect 
across main unit boundaries until turned off explicitly (see 
also sy8i:em variables "size", "slzex", "slzey") 

size ' EXPR GIVING SIZE OF CHARACTERS 

size ' SIZE IN X DIRECTION, SIZE IN Y DIRECTION (sets Independent 

sizes In x and y directions) 
size 0 or size (B) (restores standard writing) 

Note: Negative "slzex" gives backwards' characters and writing; 

negative "slzey" gives upside down characters and writing. 
Negative "size" behaves like simultaneous negative "slzex" 
and negative "slzey". 



rotate causes line-drawn characters to be mrltten at the angle specified 
In the tag; remains In effect across main unit boundaries until 
turned off explicitly (must be used with -size- tag 0) 

rotate EXPR GIVING ANGLE IN DEGREES (omit degree symbol; 

measured counter-clockwise from horizontal) 
rotate 0 o£ rotate (B) (restores horizontal writing) 



delay permits short delays during output; causes "do nothing* 
sent to the terminal for the specified delay time 



output to .be 



delay DURATION OF DELAY IN FRACTIONS OF A SECOND (maximum of 
I second; accurate to 1/60 second) 




lang sets the system variable "zlang" 
* 

lang engllsh (sets "zlang" to 0) 
lang french (sets "zlang" to 1) 
lang Spanish (sets "zlang" to 2) 
lang german (sets ''zlang" to 3) 
lang EXPR, french, x,engllsh,german 
argument x leaves "zlang 



(example of conditional form; 
unchanged) 
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inhibit temporarily disables certain normal actions of TUTOR in a unit; 
all settings are cleared at each main unit 



inhibit anserase 



inhibit 
inhibit 

inhibit 
inhibit 



arrow 
blanks 

charclear 
dropf ile 



inhibit drops^tor 



inhibit 
inhibit 



inhibit from 



inhibit 
inhibit 
inhibit 

inhibit 



(prevents automatic erasure of answer-contingent 
message .when a response is erased) 
(prevents plotting of the response arrow) 
(prevents judging if NEXT is pressed before any 
characters are typed) 
(prevents clearing of the charset flag) 
(prevents the attached file from being released 
during a jumpout) 

(prevents storage from bein^ dropped during a 
jumpout) 

(prevents use -of the EDIT key) 
(prevents normal full-screen erase when 
proceeding to the next main unit) 
(prevents return to the lesson containing this 
statement via -jumpout return- or 
-jumpout / return, return-) 

(prevents EH check before attempting a jumpout) 
(prevents /6se of the TERM key) 
inhibit clear (removes jeffect of previous -inhibit- 
commands in that main unit) 
clear, arrow, blanks (may combine tags) 



edit 
erase 



jumpchk 
term 
(B) or 



char permits specification of specially designed characters for display 
NAME ,ARG1 ,ARG2: ,ARG3 ,ARG4 ,ARG5 ,ARG6 ,ARG7 ,ARG8 

The character name (NAME) may be a number from 0 to 126 
(excluding, 63) or a defined name. Arguments ARGl through 
ARG8 are numbers which specify which of the 16 dots are 
lit in each of the 8 columns of the character space. 

; for example: 

define chi«88 $$ load chi on X 

char chi, o4020, 010040, 06300, 01600, 03140, 04020, 01(9040,0 

plot displays special character previously specified by a -char- command 
plot NAME 

plot EXPR (EXPR may have value from 0 to 126, excluding 63) 

Note: Special chara^cters may also be displayed by pressing the 
FONT key and then the key(s) where the character (s) are 
loaded into the terminal memory. Built-in characters are 
displayed after FONT is pressed again. 



char 
Note: 
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^ Graphics 




NOTE: With -dot-, -draw-, -box-, -fill-, -vector-, -window-, LOCATION is the 
screen location and may be C6ARSE or FINEX,FINEY» Coarse grid and 
fine grid coordinates may be mixed in tags with more than one argument ♦ 

dot draws a dot at the specified screen location 

dot LOCATION 

draw draws a dot, line, or line-drawn figure; after execution, '•wherex'* 
and ••wherey" are ee^t to the last point plotted 

draw LOCATION ^ ;(draws a dotj -dot- is faster if many dots are 

plotterf; -draw- is faster if lines are also being drawn) 
draw L0CATI0N1;L0CATI0N2 (draws a line) 

draw LOCATIONl;LOCATION2;LOCATION3;»»» (draws connected lines) 

draw ; LOCATION (draws a continued line> 

draw LOCATIONl ;LOCATION2;skip;LOCATION3;LOCATION4 

("skip** moves to a new position without plotting) 

Note: Maximum number of numbers in the tag is 63 ("skip" counts 
as a number)* 

box .'raws a rectangle with the specified comer locations and thickness; 

after execution, "wherex", "wherey" are set to the lower left corner 
of the box with thickness included 

box CORNER LOCATION; OPPOSITE CORNER LOCATION; DOTS THICK(opt) 
box ;CORNER LOCATION; DOTS THICK (opt) (opposite corner at current 

_ __:*wh_erQx*- ,— wherey") - - 
CORNER LOCATION- -(oWosfte at 0,0; cannot specify 

\ thickness with this form of tag) 

box (B) (equivalent to -box 0,0;51 1,511-) 

Note: Thickness, if omitted, 0, 1, or -1, is I'dot* Negative 

thickness extends inward; positive thickness extends outward* 
Maximum thickness is 95 (or -95) o 

fill fills in a rectangular area on the screen on programmable terminals; 
does not affect the setting of "wherex", "wherey" 

fill CORNER LOCATION; OPPOSITE CORNER LOCATION 

fill ;CORNER LOCATION (opposite comer at "wherex", 'Vherey'*) 

fill (B) (fills in the entire screen, i»e., corners 0,0;5il,5M) 

Note: The rectangular area is erased if -fill- is preceded by 
-mode erase- or -mode inverse-* 

. ] , , 100 ' 
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vector draws a vector symbol with specified tail and head locations and 
head size 

vector TAIL LOCATION;HEAD L0CATION;SIZE (opt) 
vector ;HEAD W)CATION;SIZE (opt) (tail at "wherex*\ "wherey") 
vector HEAD LOCATION (tail at 0,0 ; cannot specify head size) 
vector 0,0;HEAD LOCATION;SIZE (tail at 0,0 ; head size specified). 

Note: SIZE, if omitted, is 10 or 11 dots for moderate-length vectors. 
Negative size indicates open arrowhead. 

I size 1^1 is absolute (in screen dots); |size|<l is relative 
to the length of the vector, 



window establishes a rectangular "window" on the screen outside of which 
line-drawn display is not plotted; remains in effect across maia 
unit boundaries until turned off explicitly 



window CORNER LOCATION; OPPOSITE CORNER LOCATION 

window ;CORNER LOCATION (opposite corner at "wherex", 

window CORNER LOCATION (opposite corner at.JM*) 

window (B) (clears previous -window- setting) 



•wherey") 



circle draws circle with the specified parameters; the center is at the 
current "wherex", "wherey"; after execution, "wherex", '"wherey" are 
se*" to the center for a one-argument tag and to the end of the last 
line drawn for the three-argument tag 

circle RADIUS IN DOTS, START ANGLE (opt), END ANGLE (opt) 

(second and third arguments are optional: if omitted, 
START ANGLE is 0° and END ANGLE is 360^; angles are 
measured in degrees counter-clockwise from START ANGLE; 
degree sign is omitted) 



circleb same options as -circle- but draws ,a broken circle 

circleb RADIUS IN DOTS, START ANGLE (opt), END ANGLE (opt) 



101 



P8 



Relocatable graphics 



rorigln establishes a -relocatable" origin for use with -rdraw-, -rat-, 
-rbox-, -rvector-, and -rclrcle- 

rorigln COARSE 
rorigln FINEX,F1NEY 

rorigln (B) (sets relocatable origin to "wherex", "wherey") 

Note: Upon entering a lesson, the relocatable origin Is 
automatically set to -rorigln 0,0-. 

NOTE: All subsequent relocatable commands are affe<:ted by preceding 
-rorlgin-, -size-, and -rotate-. 



rat similar to -at- but relative to the -rorlgin- location^ affected 

by preceding -size- and -rotate- 
rat X-LOCATIOS , Y-LOCATION 

rat (B) (equivalent to -rat 0,0-, I.e., the current 
-rorlgin- location) 

ratnm similar to -rat- but does not reset the left margin (see -atnm-) 
ratum X-LOCATION,Y-LOCATION 

rdot draws a dot at the specified position relative to the -rorlgln- 
locatlon; position Is affected by preceding -size- and -rotate- 

r do t X-LOCATION , Y-LOCATION 



rdraw similar to -draw- but figure Is affected by preceding -size- and/or 
-rotate-; the last point plotted serves as the location for the next 
screen activity 

rdraw TAG LIKE -draw- EXCEPT WITH RESPECT TO -rorigln- LOCATION 
(i.e.. In screen dots from the -rorigln- location) 

rbox similar to -box- but draws a rectangle relative to the -rorlgin- 
location; affected by preceding -size- and -rotate-^(see -box-) 

rbox' CORNER X.CORNER Y;OPPOSITE CORNER X, OPPOSITE CORNER Y; 
DOTS THICK (opt) 

rbox ;CORNER X.CORNER Y;DOTS THICK (opt) (opposite comer at 

"wherex", "wherey") 
rbox CORNER X,CORNER Y (opposite corner at -rorigln- location; 
O cannot specify thickness with this form of tag) 



ERIC 



102 



P9 



rvector similar to -vector- but draws vector symbol relative to the -^rorlgli 
location; affected by preceding -size- and -rotate- (see -vector-) 

rvector XTAIL,YTAIL;XHEAD,YHEAD;SIZE (opt) 

rvector ;XTAIL,XHEAD;SIZE (opt) (tall at "wherex", "wherey") 

rvector XHEAD,YHEAD (tall at -rorlgln- location) 

rvector 0,0jXHEAD,YHEAD;'SI2E (tall at -rorlgln- location) 



rclrcle same options as -circle- but Is affected by preceding -rotate- and 
-size-; gives an ellipse If preceded by two-argument -size- with 
unequal arguments (see -circle-) 

rclrcle RADIUS IN DOTS, START ANGLE (opt), END ANGLE (opt) 

(specify basic radius before affected by -size-) 
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Drawing graphs 



gorlgin specifies location of the origin of the graph; all other display 
with graphing conunands is relative to this origin 

gorigin COARSE 
gorigin FINEX,FINEY 

gorigin (B) (sets graph origin to 'Vherex", "wherey") 

Note: Upon entering a lesson, the origin is automatically set . 
to -gorigin 0,0-. 

axes specifies lengths of the axes and draws the axes; remains In effect 
across main unit boundaries until reset; x and y values are in dots 
relative to the -gorigin- location 

axes NEGATIVE X,NEGATIVE Y, POSITIVE X, POSITIVE Y 
axes POSITIVE X,POSITIVE Y 

axes (B) (draws axes specified by the last -axes- or ^bounds-) 

Note: Tp dr^*w one-quadrant axes (other than both positive axes) with 
^ labeling on the outside of the axes, ^'se four-argument form of 

the tag with arguments corresponding > m^ 'aing axes set to 0. 

/ 

bounds specifies lengths of the axes but does net draw the axes (i.e., axes 
are invisible); remains in effect across main unit boundaries until 
reset; x and y values are in dots relative to the -gorigin- location 

bounds NEGATIVE X, NEGATIVE Y, POSITIVE X, POSITIVE Y 
bounds POSITIVE X, POSITIVE Y 

bounds (B) (sets up bounds specified by the last -axes- or -bounds-) 

Note: Upon entering a lesson the boundaries are automatically 
set to -bounds 511,511-. 



scalex specifies the maximum valu^ and the value at the, origin on the 

X axis; remains in effect across main unit boundaries until reset 

scalex MAXIMUM VALUE OF X, VALUE OF X AT ORIGIN (opt) 
(value at origin, if omitted, is 0) 



scaley same options as -scalex- but for the y axis 

scaley MAXIMUM VALUE OF Y, VALUE OF Y AT ORIGIN (opt) 
(vclue at origin, if omitted. Is 0) 
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Iscalex 



specifies the maximum value and the value -at the origin on the 
X axis; the scale between these points la proportional to the 
logarithm of maximum x divided by the value at the origin; remains 
in effect across main unit boundaries until reset - 



Iscalex MAXIMUM -VALUE OF X, VALUE OF X AT ORIGIN (opt) 

(value at origin, if omitted, is 1, i.e., 10^*) 



Iscalej^ 



same options as -Iscalex- but for the y axis 



Iscaley MAXIMUM VALUE OF Y, VALUE OF Y AT ORIGIN (opt) 

(Value at origin, if omitted, is I, i.e., 10^) 



NOTE: If any of the commands -scalex-, -scaley-, -Iscalex-, -Iscaley- are 
omitted, a Hnear scale with length set by the preceding -axes- or 
-bounds- is assumed. 

NOTE: Subsequent graphing commands are in appropriate scaled units. 



labelx MAJOR INTERVAL, MI NOR INTERVAL(opt) ,MARKSIZE(opt) ,FORMAT(opt) 
labely specifies mark intervals, draws tick marks, and labels the y axis 



markx specifies mark intervals; draws tick marks on the x axis with no labels 
markx MAJOR INTERVAL, MI NOR INTERVAL(opt) ,MARKSIZE(opt) 



marky specifies mark intervals; draws tick marks on the y axis with no labels 
marky MAJOR INTERVAL, MI NOR INTERVAL(opt) ,MARKSIZE(opt) 



NOTE: The total number of marks on an axis cannot exceed 100* 

MAJOR INTERVAL - 0 (with linear scale) to select the "best" interval 

automatically 
MINOR INTERVAL 0 or omitted to omit minor marks 
MARKSIZE " 0 or omlttc ^ for normal label marks 
MARKSIZE « 1 for major marks extending^ to bounds of the graph 
MARKSIZE " 2 for all marks extending ''to bounds of the graph 
FORMAT gives the format for the labels and has the same form as that 
for ~8howt-> e#g., 1.2 or 1,2. FORMAT is optional; if omitted, the 
label format is selected automatically and depends on .the scale. 
Blank fields are not permitted; use 0 where appropriate. 

(NOTE continued on next pageO 1 nr 



labelx specifies mark intervals, draws tick marks, and labels the x axis 



labely MAJOR INTERVAL, MI NOR INTERVAL(opt) ,MARKSIZE(opt) ,FORMAT(opt) 
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NOTE:, (continued from preceding page) 
For labeling log scales: 

MAJOR INTERVAL must be 0 (major marks are automatically plotted every 
decade) 

MINOR INTERVAL < 0, minor marks are not plotted 

MINOR INTERVAL » 0 or 3 (or omitted), minor marks are placed at values 

of 1, 2, 5 within the decade 
MINOR INTERVAL • 5, minor marks are placed at 1, 2, 3, 5, 7 
MINOR INTERVAL « 10, minor marks are placed at 1,2, 3, 4, 5, 6, 7, 8, 9 

polar causes tags of graphing commands to be Interpreted as polar 

coordinates containing scaled radius and polar angle; may set scales 
on X and y axes; remains in effect actoss main unit boundaries until 
' turned off explicitly; polar conversion and scaling must be turned 
off independently 

polar (B) (turns on polar conversion) 

polar MAXIMUM VALOE OF X AND l( (turns on polar conversion 

and scales both axes]j 
polar MAXIMUM VALUE OF X, MAXIMUM VALUE OF Y (turns on 

polar conversion and! scales axes independently) 
polar NEGATIVE VALUE (turns/ off polar conversion but not scale) 

NOTE: When the tag of subsequent commands is interpreted in polar coordinates, 
the degree sign must be used if the angle is in degrees. Without the 
degree sign, the- angle is interpreted in radians. 

gat similar to -at- but specifies the screen location relative to the 

-gorigin- location and in scaled units 

ga t X-LOCATION , Y-LOCATIOU 

gat DISTANCE,ANGLE (with -polar-) 

gat (B) (equivalent to -gat 0,0-, i.e., the current 
7gorigin- location) 

gatnm similar to -gat- but 'does not reset the left margin (see -atnm-) 

gatnm X-LOCATION,Y-LOCATION 

gatnm DISTANCE, ANGLE (with -polar-) 

gdot draws a dot at the specified position relative to the -gorigin- 
location and in scaled units 

gdot X-LOCATION,Y-LOCATI()N 

gdot DISTANCE, ANGLE (with -polar-) 
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places a dot or character string centered at the position Indicated 
relative to the ^gorigln- location and In scaled units 

graph X-L0CATI0N,Y-LOCATI0N, STRING (opt) (maximum of 9 characters 
In STRING; If STRING Is not specified, a dot Is plotted) 

graph DISTANCE, ANGLE, STRING (with -polar-) 

graph X-L0CATI0N,Y-LOCATI0N;VAR,NUM CHARACTERS (opt) 

(If NUM CHARACTERS Is omitted, 10 characters are plotted) 

graph DISTANCE, ANGLE ;VAR, NUM CHARACTERS (with -polar-) 



graph 



• 



gdraw like -draw- but relative to the -gorigin- location and in scaled units; 
after execution "wherex", "wherey" are set to the last point plotted 

for example: , 

gdraw Xl,Yl;X2,Y2 (draws a line on the graph) 

gdraw DISTANCEl,ANGLEl;DISTANCE2,ANGLE2 (with -polar-) 

gbox same options as -box- but draws a rectangle relative to the -gorigin- 
location; affected by preceding -scalex- and -scaley (see -box-) 

gbox CORNER X, CORNER Y;OPPOSITE CORNER X, OPPOSITE CORNER Y; 

DOTS THICK (opt) 
gbox DISTANCE CORNER^ANGLE CORNER; DISTANCE OPPOSITE CORNER, 

ANGLE OPPOSITE CORNERrDOTS THICK (with -polar-) 
gbox ; CORNER X, CORNER Y;DOTS THICK (opt) (draws a box 

with opposite corner at current "wherex**, ''wherey") 
gbox ;DISTANCE CORNER,ANGLE CORNER; DOTS THICK (with -polar-) 
gbox CORNER X, CORNER Y (draws a box with opposite corner at 
-gorigin- location; cannot specify thickness with this 
forp of the tag) 
gbox DISTANCE CORNER,ANGLE CORNER (with -polar-) 
gbox (B) (draws a box set by a previous -axes-Z-bounds- and 
-scalex-/-scaley-) 



gcircle same options as -circle- but is affected by preceding -scalex- and 

-scaley-; draws an ellipse if the -scalex- and -scale^- settings are 
different (see -circle-) 

gcircle RADIUS IN DOTS, START ANGLE (opt), END ANGLE (opt) 

(specify basic radius before affected by -scalex-, -scaley-) 



\ 
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gvector same of^ions as -vector- except draws vectoiLsymb.pl relative to the 
-gorlgin- location and in scaled units (see -vector-) 

gvector XTAIL,YTAIL;XHEAD,YHEAD;SIZB (opt) 

gvector DISTANCETAIL ,ANGLETAIL;DISTANCEHEAD ,ANGLEHEAD; SIZE(opt ) 
(with -polar-) 

gvector ;XHEAD,YHEAD;SI2E (opt) (tail at "wherex", "wherey") 
gvector ;DISTANCE HBAD,ANGLE HEAD; SIZE (opt) (with -polar-) 
gvector XHEAD,YHEAD (tall at -gorlgin- location) 
gvector 0/0;XHEAD,YHEAD;SIZE (tall at -gorlgin- location) 
g^ctox LENGTH,ANGLE (tall at -gorlgin- location; with -polar-) 

Note: Because of the default conditions of -gorlgin 0,0- and 

rbounds 511,511-, -gvector- used without preceding -gorlgin- 
^' and -bounds- gives the same result as -vector- with fine-grid 

coordinates. \ ^ 

vbar draws a vertical bar at the specified location relative to the 
-gorlgin- location and in scaled units 

vbar X-LOCATION,HEIGHT, STRING (opt) 

vbar DISTANCE BAR TOP, ANGLE BAR TOP^STRING (with -polar-) 
vbar X-LOCA?IOH,HEIGHT;VAR,NUM CHARACTERS (opt) 
vbar DISTANCE BAR TOP, ANGLE BAR TOP;VAR,NyM CHARACTERS 
(with -polar-) 



hbar draws a horizontal bar at the specified location relative to the 
-gorlgin- location and in scaled units 

hbar LENGTH, Y-LOCATION, STRING (opt) 

hbar DISTANCE BAR END.ANGLE BAR END, STRING (with -polar-) 
hbar LENGTH, Y-LOCATION; VAR,NUM CHARACTERS (opt) \ 
hbar DISTANCE BAR END^ANGLE BAR END;VAR,NUM CHARACTERS \ 
(with -polar-) \ 



NOTE: With -vbar- and -hbar-, STRING may have up to 9 characters* If STRING 
Is omitted, & rectangle is drawn- If the character string is stored in 
a variable and number of characters is omitted, 10 characters are drawn. 
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delta specifies stepslze for subsequent -f unct- commands 
delta STEPSIZE 

Notje: If -delta-* is omitted » the stepslze Is set to 1* 

funct plots the curve specified In the tag» with the stepslze given by a 
preceding -delta- or by the stepslze given In the tag 

funct FUNCTION EXPR^INDEPENDENT VAR 

Note: Range of Independent variable Is set by boundaries of 
-axes- (or -bounds-) and -scalex- commands. 

funct FUNCTION EXPR, INDEPENDENT VAR^- INITIAL, FINAL, STEPSIZE 

Note: If Initial or final values of the Independent variable are 
beyond previously set boundaries, the latter are used. 
For polar functions If Initial or final value is omitted, 
it is assumed to be 0 or 2Tr, respectively.' 

With either form of -funct-, a v-varlable is recommended 
for thh Independent variable* 



NOTE: With -delta- and -funct-, select a stepslze that gives a smooth graph 

but plots quickly. A reasonable lower limit to the stepslze for a 
graph with- linear x axis is: , 

I STEPSIZE I ^ .02X I FINAL VALUE - INITIAL VALUE | . 
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Non-Screen 



slide operates the slide projector and selects the specified slide 

slide SLIDE NUMBER (value from 0 to 255) 

slide ROW+16XCOL0MN (ROW, COLUMN from 0 to 15) 

slide 512 (turns off lamp) 

slide 256 (closes shutter) 

slide 512+SIiIDE NUMBER (selects slide with lamp off) 

slide 256+SLIDE NUMBER (selects slide with shutter closed) 

slide noslide / (selects slide 0, turns off lamp, closes shutter) 



audio sends the value of the tag (truncated to 15 bits) to the external 
device connected to the -audio" jack 

audio EXPR 



play plays the audio device recording at the message location specified 
play TRACK,SECTOR,NUM SECTORS (128 tracks, 32 sectors each)' 

record records a message at the location specified 
record TRACK, SECTOR,NUM SECTORS 



enable allows input from the touch panel and from external devices 

enable touch 
enable ext 

enable touch, ext (may combine tags) 

Note: --enable touch- must be reset for each -arrow- command in a 
unit and after any full-screen erase. 

-enable touch- in a unit with no -arrow- allows any touch 
on the screen to have the effect of pressing NEXT, 
-enable ext- is turned off only by -disable ext-. 



disable prevents input from any device except the keyset; this is the normal 
state of the terminal 

disable touch 
disable ext 
disable touch, ext 
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ext sends the value of tlie tag (truncated to 15 bits) to an external 

device (or to the device at another station if "ext" option has 
been turned on by the receiving user) 

ext EXPR 

ext EXPR, STATION 

Note: zreturn " -1 if data is sent successfully 
• 0 otherwise 



ext out sends the value of the right-most 16 bits of the specified variables 
to an external device; the 16th bit from the right determines how the 
information is interpreted: 1 for ext, 0 for audio 

extout STARTING VAR,NUM VARS (opt) (NUM VARS, if omitted, is 1) 

xout sends data (in 8-bit bytes) contained in the specified variables to 
an external device (available only on programmable terminals) 

xout DEVICE ADDRESS (establishes an address for use by subsequent 

-extout- or -ext- commands) 
xout ADDRESS, STARTING VAR,NUM BYTES, SEGMENT SIZE (opt) 

(SEGMENT SIZE, if omitted, is 60; if SEGMENT SIZE > 8, 

only the right-most 8 bits are sent) 

Note: zreturn ■ -1 If the data Jls sent successfully 

» 0 if STOP or STOPl is pressed during transmission 

xin collects data (in 8-bit bytes) from an external device and stores it 

in the specified variables (available only on programmable terminals) 

xin DEVICE ADDRESS (establishes an address to be read upon 

subsequent external interrupt requests) 
xin , ADDRESS, STARTING VAR,NUM BYTES, SEGMENT SIZE (opt) 
— (SEGMENT SIZE, If omitted, is' 60; if SEGMENT SIZE > 8, 

the right-nost 8 bits of "key" are stored, right-justified, 
in each segment) 

Note: zretv\rn " -1 if the data is received successfully ^ 

" 0 if STOP or STOPl is preased during transmission 



beep (no tag) rings the sound device on programmable terminals 



NOTE: Commands -xout-, -xin-, -beep- may be used only at a programmable 
terminal. 

For current Information on device addresses, see the descriptions of 
-xin- or -xout- in "aids"* 
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saylang specifies the language to be spoken by a phoneaiic synthesizer which 
is operated by the terminal (languages currently available: WES 
[World English Speilingl, ipa [International Phonetic Alphabet], 
Esperanto, and Spanish); currently works only with Vot rax model VS-6 

saylang LANGUAGE / 

saylang (B) or saylang q " (turns off subsequent -say- commands) 
saylang EXPR,LANGUAGEM,LANGUAGE0,q, LANGUAGE 2, x (example of 
conditional form) 

say specifies the sentence to be spoken by the synthesizer 

— ; say ' SENTENCE PR PHRASE .(may include embedded information) 

sayc specifies the sentence to be spoken by the synthesizer depending 
on the value of a conditional expression 

sayc EXPR^PHRASEMJpHRASE0^PHRASEI 



- / 
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Special display 



tabset sets tabs vhich are used by a user pressing the TAB key; remains in 
effect across unit boundaries until reset 

tabset OCTAL NUMBER CONTAINING 10 PACKED TAB SETTINGS FRCXl 

LEFT TO RIGHT (each setting is a 6-bit octal number giving 
the horizontal character position; unused settings to 
the right must be filled with octal zeros) 

for example 9 to set tabs at horizontal character positions y 
8, 21, 30, 48, 56, and 63, use: ^' — - 

tabset ol0 25 36 60 70 77 00 00 00 00 

Note: The tag may be an n*variable which contains the packed settings < 

micro specifies mlcrotable definitions used when the user presses the 
MICRO key and then another key;- unless specified, microtable and 
-micro* command are in the same lesson 

micro (0), MICROTABLE NAME 
micro (zlesson), MICROTABLE Mm 
micro , MICROTABLE NAME 
micro MICROTABLE N^ 

micro LESSON NAME, MIC ROTABLE NAME (LESSON mfE contains the 

microtable; enclose variable arguments in parentheses) 
micro <LESLIST POSITION>,MICROTABLE NAME 

micro (B) (cancels microtable in effect and restores built-in 
microtable definitions) 



Note: zreturn 



--1 if the microtable is available 
0 if the microtable Is not found 



charset causes the specified character set to be loaded into the terminal 
me^nory (see -inhibit charclear-); 1-block charset may contain 
up to 79 characters, 2*-block charset up to 126 characters; unless 
specified, the charset and -charset- command are in the same lesson 

charset (0),CHARSEJ NAME 
charset (zlesson), CHARSET NAME 
charset ,CHARSET NAME 

charset CHARSET NAME X 
charset LESSON NAME, CHARSET NAME (LESSON NAME co;itains the charset 

blocks; enclose variable arguments in parentheses) 
charset <LESLIST POSITION>, CHARSET NAME 
charset (B) (clears charset flag) 

Note: zreturn » if the character -set is loaded successfully 
■ 0 if the character set is not found 
> 1 if the STOP key is pressed during loading 
Q ^ » 2 if there is an error in loading 

^13" 3 if there is a disk error : 
■OH * 5 if the variable for^'tt^ charset name equals 0 



chartst allows check for 4)re8ence of a character set in the terminal inemory; 
sets "zretum** to -1* If the charset flag Is set and to 0 If not 

chartst (0),CHARSET NAME 
chartst (zlesson), CHARSET NAME ^ 
chartst , CHARSET NAtlE 
chartst CHARSET NAME 

chartst LESSON NAIiB> CHARSET NAME (LESSON NAME contains the 

charset; enclose variable arguments In parentheses) 
chartst <LESLIST POSITION>, CHARSET NAME 



llneset allows use of line-drawn characters, which are affected by preceding 
-size- and -rotate-; **size" must not be 0; llnechars ^re accessed by 
the FpNT key or by -alt font on- ; a llneset may be up to 3 blocks 
long; 1 block may contain up to 128 small llnechars; unless specified, 
llnese^blocks and -llneset- command are In the same lesson 

llneset (0),LINESET NAME 
llneset (2lesson),LINESET NAME 
llneset ,LINESET NAME 
llneset LINESET NAME 

llneset LESSON NAME, LINESET NAME (LESSON NAME contains the 

llneset; enclose variable arguments In parentheses) 
llnesec <LESLIST POSITION>, LINESET NAME 

llneset (B) (cancels llneset in effect and restores standard 
sized writing) 

Note: zreturn « -I If the llneset Is attached successfully 
* 0 If the llneset Is not found 
« +1 If there Is an error In the llneset 



alt font changes font mode of the terminal; affects charsets and llnesets 

altfont on or altfont 1 or altfont alt (switches terminal 

to alternate font) 
altfont off or altfont 0 or altfont. normal (switches 

terminal to normal font, which Is the default state) 

• Note: Tag may ^be calculated, but It must be exactly 0 or 1. 

Altfont setting remains In effect across unit boundaries 
until reset by another -altfont- command or until -jumpout- 
Is executed*. 
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System variables for presenting 



node • -1 with -mode erase- 



" f "i'l! J. see -mode- command 

* 1 with -taode write- f \ 

• 2 with -mode inverse- J ^ 



size current .value of the j tag of the single-argument -size- cCifltnand 

(see -size- command) ' 



sizex current value of the ''x** argument in the two-argument -size- command \ 

sizey current value of the **y** argument in the two-argument -size- command 

where character-grid location for next display ^ 

wherex fine-grid x location for next display 

wherey fine-grid y location for next display 



See CALCULATING, 
System functions, 
for zfinex(X), zfiney(X) 



zlang us^e^ul for display of multi-lingual text; set by -lang- command 
^ for -lang english- 
» <L for -lang french- 
■ 2 for -lang spanish- 
V « 3 for -lang german- 



\ 
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ROUTING " Rl 



Router lesson" 



routes 



used in a router lesson to specify to which unit in the router 
lesson the user is sent upon leaving the instructional lesson 

route end lesson, UNIT NAME (exit via -end lesson- or -jumpout q-) 
route error, UNIT NAME (exit via execution error or condense error) 
route finish,UNIT NAME (exit via STOPl) 

route resignon,UNIT NAME (opt) ' (upon STOPl exit from a lesson, 
provides the user with a choice page offering the option 
to sign off completely or to continue working 
(i.e., to return to the router, to the specified unit, 
if give , or to the first unit if UNIT NAME is omitted]) 



routvar (non-executable) sets up special variables in a rout^^r lesson which 
can be used only in the router lesson; they are referenced by 
vr and nr 

routvar NUM VARS (maximum of 64 variables) 



allow used in a. router lesson to specify that router common and/or 

router variables- may be referenced in the instructional lesson 

allow read (read-only access to router common) 

allow write (read and write access to router common) 

allow read rvars (read-only access to router variables) 

allow (B) (clears last setting of -allow-) . 
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Curriculum Information 



NOTE: The following commands are used In Instructional lessons. 

lesson sets the system variable "Idone*' to Indicate whether the user has 
completed the lesson 

lesson complete (sets "Idone** to -1) 
lesson Incomplete (sets "Idone" to 0) 

lesson no end (sets "Idone" to-'fl; may be used in lessons with 
no logical end) 

lesson EXPRyCompleteylncompleteyX^no end (example of conditional 
form; argument x leaves "Idone" unchanged) 



score places the value of the tag, rounded to the nearest Integer, into 
the system variable "Iscore" 



score EXPR 
score (B) 



(value from 0 to 100) 
(sets "Iscore" to -I) 



status places the value of the tag, rounded to the nearest Integer, into 

the system variable "Istatus"; allows a user to reestablish a status 
upon returning to a lesson after having entered other lessons 



status EXPR 
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System variables for routing 



errtype ■ 0 for unknown error type 

■ 1 for execution error 

■ 2 for fatal condense error or for attempted jumpout to a router 

not specified for the group 

■ 3 for memory exceeded 

■ 4 for error In the finish unit of the Instructional lesson 

■ 5 for. exit" from the condense queue via STOPl 

idone ■ -1 If the user has encountered -lesson complete- or 
"-end lesson- 

* 0 if the user has encountered -lesson incomplete- £r has never 
entered the lesson jor has entered but not completed the lesson 
(-records Idonelist- returns a value of 2 for the last case 
when "mrouter" is used) 

■ +1 if the user has encountered -lesoon no end- 



Iscore rounded value of the tag of -score- (value from 0 to 100); initially 
set to -1 for a user routed by "mrouter"; may also be set to -1 wlth^ 
-score (B)-; initially set to 0 for a user not routed by "mrouter" 



Istdtus^ rounded value of the tag of -status- 



rcallow " 0 for no access to router common 
« 1 for -allow read- 
» 2 for -allow wrlte- 



router name of the router lesson (left-justified; display with -showa-) 



rstartl name of the lesson from the last -restart- comcund 
(left- justified; display with -showa-) 



rstartu name of the unit from the last -restart- conrmand 
(left-justified; display with -showa-) 



rvallow ■ 0 for no access to router variables 
«■ 1 for -allow read rvars- 



zcurrtc name of the instructor file when "mrouter" is the router 
(left-justified; display with -showa-) 
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zleserr gives detailed Information on fatal errors which can \cccur when 
accessing s lesson (l«e*» errors that give a student Vhe message 

"Call Your Instructor") 

« 0 If there is no error or If the error Is non-fatal 

« 1 If the condensor is not available 

" 2 if the lesson does not exist 

" 3 if the lesson 'source code is too long 

« 4 if EM is not available (although the site EM allocation is 

not exceeded) 

« 5 (system error) 

« 6 if there Is a^disk error 

» 7 if there is a unit which is too long 

" 8 if the lesson has been deleted 

» 9 (not used) ^ 

« 10 if there is no room in EM for the lesson common 

-11 if the common is not found 

» 12 if there are not enough common blocks 

" 13 (system error) 

=» 14 if there is a common codeword error 

« 15 if there is a tag which is too long 

» 16 if the lesson binary is too long 

» 17 if the lesson is not a TUTOR lesson 

=« 18 if the lesson is temporarily unavailable 

=» 19 if the site EM allocation is exceeded 

=» 20 (system error) 

=* 21 (system error) , 

« 22 if there is an error in specifying the router 

« 23 if there is a junpout codeword error 

» 24 if the common in EM has a. different length from the length 

specified in the -common- command 

» 25 if a jumpout to the wrong router is attempted 

» 26 if ther - is an error in the -use- command (other than 

"block not found") 

= 27 (system error) 

« 28 if the lesson is not available (not used on the CERL system) 

« 29 (not used) 

«.30 if the lesson is obsolete and must be converted 

a 31 if there is an error in the -use- command: block not found 

a 32 if the processor lesson is not a valid TUTOR file 



IID 



ERIC 



\ 



SEQUENCING 



SI 



Battle sequencing 



unit 



names and Initiates a section of a lesson (called a unit) which may 
be referenced by other sequencing conunands 



unit 



NAME (maximum of 8 characters In NAME) 



unltop similar to -unit- but without a full-screen erase when the unit Is 

entered (except upon Initial entry Into a lesson); "mode" and "where 
are not altered 



NOTE: Initial entry unit (leu) refers to commands preceding the first -unit 
or '-unltop- command In a lesson; these are executed whenever and 
wherever a lesson Is entered (except when a lesson executes sjumpout- 
to Itself or when a router lesson is returned to during the session). 

See -define- for formats for a local define set, which is declared as 
a continuation of a -unit- command « 

entry names a section of a lesson which may be referenced by other 



sequencing commands; does not affect the flow of execution of the 
unit in which the -entry- command is placed except that -entry- may 
not be placed within the range of -branch-, -doto-, -if-, or -loop-; 
no keypress is required to execute commands following -entry-; 
no full-screen erase or other main-unit initializations occur 
* following -entry- when it is executed within a unit 

entry NAME (maximum of 8 characters in NAME) 



NOTE: Cozmnands -unit-, -unltop-, and -entry- may have a. form with arguments: 
uult NAME(VARI,VAR2,VAR3,*,0 (up to 10 arguments) 



A lesson may have up to 394 different unlets referenced by -unit-, 
-unltop-, and -entry-* No unit may be named "q" or "x". 
Maximum length of a unit is 500 condensed wordp. 



unltop NAME (maximum of 8 characters in NAME) 
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Automatic sequencing 

NOTE: The following conunands (-Jump-, -goto-, -do-, and -Join-) may have a 
conditional form, e*g*, 

goto EXPR,NAMEM,NAME0,NAMEl,x,NAME3,q 

do BXPR,NAMBM,HAME0,x,NAME2,q,VAR* INITIAL, FINAL, STEP 

Argument x Is equivalent to absence of the command; argument q Is 
equivalent to a branch to an empty unit. Special case occurs with . 
-do q- (--Join q-), which Is equivalent to -goto q-. For Iterative 
-do-, q terminates the -do-, and x Indicates no Iteration Is done for 
that value of the conditional expression. Argument q Is not valid with 
-Jump-x Up to 100 arguments are permitted in the conditional tag. 

These commands may pass up to 10 arguments, e.g., 

goto NAME ( VALUE 1,VALUE2,,VALUE4) (values may be expressions) 

unit NAME(VAR1,VAR2,VAR3,VAR4) (VAR3 is anchanged) 

or 

~do NAME(VALUE1,VALUE2;VAR1,VAR2,VAR3) (-return- returns 

values to VARl, VARl, VAR3) 



jump causes execution of the unit named in the tag with a full-screen 
erase (unless the erase is prevented: see -inhibit erase-) and 
change of main unit; Initializations associated with entering a 
main unit are performed 

Jump UNIT NAME 



causes execution of the unit named in the tag without a screen erase, 
without change of main unit, and without other main-unit 
initializations; there is no further execution of commands in the 
original unit except during the Judging process 

goto UNIT NAME 

do (inseriion) causes execution of the unit named in the tag without 

screen erase or change of main unit; returns to the oi;lglnal unit 
to execute commands following *-do- 

(iteration) causes repeated execution of unit(s) named in the tag while 
changing a counter; otherwise same as insertion -do- 
do UNIT NAME 

do NAME, VAR* INITIAL EXPR, FINAL EXPR,STEPSIZE EXPR (opt) 

(STEPSIZE, If omitted, is +1; STEPSI2E may be negative; 
' loop variable is undefined after completion of the loop) 

Note: Nested -do- and -join- levels may be up to 10 deep. 



goto 
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Join similar to -do- but is executed during judging and during search 
for additional --arrow- coaimands following an "ok" judgment 

join UNIT NAME 

join NAME,VAR<« INITIAL EXPR, FINAL EXPR,STEPSI2E EXPR (opt) 

return returns Values to variables specified in a "-unit- cojmnand with 
^Il^^^arguments 

return EXPR1,EXPR2,EXPR3 (maximum of 10 arguments) 
Note; -return- occurs in a unit executed via -do- or -join-, 
do NAME(EXPR; VARl , VAR2 ) 

unit NAME(VAR) 

• 

return EXPR1,EXPR2 (returns values to VARl, VAR2) 



exit permits termination of -do- or -join- sequences 

exit ' (B) or exit NEGATIVE VALUE (exit from all levels 

of -join- and -do-) 

exit EXPR GIVING NUM LEVELS 
exit 0 (causes no exit) 

iferror specifies the unit to execute via a -goto- if an error is found 
in the execution of a subsequent calculation in a unit 

iferror UNIT NAME 

iferror (B) or iferror q (turns off -iferror- setting for 

remainder of unit) 
iferror EXPR,NAMEM,NAiblE0,q,NAME2,x (example of conditional form; 
maximum of 100 arguments in conditional tag) 

imain specifies the unit to execute at the start of every main unit in the 
lesson; later occurrence of the command overrides an earlier setting; 
equivalent to -do- at the beginning of each main unit 

imain UNIT NAME 

imain (B) or imain q (turns off -imain- setting for 

remainder of lesson or until reset) 
imain EXPR,NAMW,NAHE0,q,NAME2 ,x (example of conditional form; 
maximum of 100 argumencG in conditional tag) 



12: 



NOTE: The. following two commands (-branch-, -doto-) permit branching or 

' looping within a unit. The command may appear in the command field or 
in th^ tag field. In the tag field the command is part of a continued 
-calc-» 



branch permits branching within a unit (the statement label .must start 
with a number and ma^ contain up to 7 characters) 

for example: 

5a VAR« EXPR 

do someu ^ 

write ^me message 

branch EXPR, 5a, x (argument x causes fall-through to the next 

line in the unit) 

calc VAK<F EXPR 
6 test VAR« EXPR 

branch 6test 

branch x (causes fall-through to next line in the -calc^) 
branch EXPR,x,6test (example of conditional form) 

doto permits looping within a unit (the statement labal must start with 

a number, may contain up to 7 characters, and must have a blank tag) 

for example: 

doto 2sync,VAR« INITIAL EXPR, FINAL EXPR,STEPSIZE EXPR 

do someu 

write some message 



2sync (B) 



calc VAR« EXPR 

doto 4run,VAR«« INITIAL EXPR, FINAL EXPR,STEPSIZE EXPR 

4run , (B) 

Note; Stepsize, if omitted, is +1. Stepsize may be negative* 
Value of the loop variable is undefined after completion 
of tha loop. 
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NOTE: The following four commands (-if-, •elseif7, -else-, and -endif-) 
permit branching within a unit. Logical value of an expression is 
if its rounded value is -1 and "false" if its roundi d .value is 0. 



•true' 



if performs a branch based on the logical value of the tag expression; 

value of "true** causes fall-through to the next xine; value of '•false" 
causes branch to the next -elseif-, -else-, or -endif- at the same 
level; code, following -if- must be indented (up to the next -elseif-, 
-else-, or -endif- at the same level) and marked with the indent 
symbol; range of -if- must be terminated by -endif- at the same level 



if 



LOGICAL EXPR 



elseif provides an alternative branch within the range of the preceding 
-if- at the same level; subsequent code follows same indenting 
rules as -if- 

elseif LOGICAL EXPR 



else (no tag) provides a branch if the logical value of the tag of the 

preceding -if- or -elseif- at the same level is "false"; subsequent 
code follows same indenting rules as -if- 



endif (no tag) marke the end of the range of the preceding -if- at the 
same level 



NOTE: Following is an example demonstrating placement of these commands. 



if * 


n8<4 












vnrite 


first branch 


$$ executed 


if 


n8<4 




calc 


n9^ 34 


$$ executed 


if 


n8<4 


elseif 


n8-4 




$$ executed 


if 


.iJ'.^4 




write 


second branch 


$$ executed 


if 


n8«4 




do 


someunit 


$$ executed 


if 


n8=-4 


else 






$$ executed 


if 


n8>4 




write 


default branch 


$$ executed 


if 


n8>4 




if 


n8>6 


$$ executed 


if 


n8>4 




• 


write special branch 


$$ executed 


if 


n8>6 




endif 




$$ end of range of -if 



endif 



f I end of range of -if 



n8>6- 
n8<4- 



ERIC 



1 O ^ 

J. Aw ^ 



NOTE; 



The following four commands (-loop-, -endlWrT-outloop-, and -reloop-) 
permit looping within a unit. Logical valu^j)f an expression Is "true" 
If its rounded value is -1 and "false" if its rounded value is 0. 



loop initiates a loop based on the logical value of the tag expression; 

value of "true" causes execution of subsequent commands in the loop; 
value of "false" causes execution of the first command e. ter -endloop- 
at the same level of indentation as -loop-; code following -loop- must 
be Indented (up to the next -outloop-,. -reloop-, or -endloop- at the 
same level) and marked with the indent symbol; range of -loop- is 
marked by -endloop- at the same level 

loop LOGICAL EXPR (blank tag is equivalent to "true" value) 

endloop (no tag) marks the end of a loop initiated by the previous -loop- 
command at the same level of indentation; causes a branch back to 
the previous -loop- command at the same level 

outloop based on the logical value of the tag, causes exit from the range of 
-loop- at the same level of indentation; value of "true" causes 
execution of the first command after -endloop- at the same level; 
value of "false" causes execution of subsequent commands within the 
loop, which follow the same indenting rules as -loop- 

outloop LOGICAL EXPR (blank tag is equivalent to "true" value) 

reloop based on theological value of the tag expression, causes branch "back 
to the previous -loop- command at the same level of indentation 
without terminating the loop; value of "true" causes branch to the 
previous -loop- at the same level; value of "false" causes execution 
of subsequent commands within the loop, which follow the same 
Indenting rules as -loop- 

reloop LOGICAL EXPR (blank tag is equivalent to "true" value) 



Note: Following is an example demonstrating placement of these commands, 
loop 



reloop 



n8<10 
write 
subl 
n8^5 
write 
do 

outloop n8<3 
write 

endloop 
write outsic 



within loop 


$$ 


executed 


if 


n8<10 


n8 


$$ 


executed 


if 


n8<10 




$$ 


executed 


if 


n8<10 


still within loop 


$$ 


executed 


if 


n8<5 


someunit 


$$ 


executed 


if 


n8<5 




$$ 


executed 


if 


n8<5 


still within loop 


$$ 


executed 


if 


3:^n8<5 


of loop 


$$ 


executed 


if 


n8^10 or n8<3 



V 
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Key-initiated sequencing 



NOTE: The following commands (-next- through -lablop-) may have the 

conditional form, where argument x leaves the pointers unchanged, and 
argument q clears the pointer and renders the key inactive (except for 
NEXT, which causes fall-through to the following unit). Argument q is 
not valid with -nextnow-. Up to 100 arguments are permitted in the 
conditional tag. The conditional fjxpression is evaluated when the 
'command is executed, not when the key is pressed. 



next, nextl, back, backl, stop specifies the unit executed when the user 
presses the appropriate key (arrows must be satisfied before 
sequencing on the NEXT key); the specified unit is a main unit 



next UNIT. NAME 
backl UNIT NAME 
back (B) or back 



q (clears back pointer; disables BACK key) 



nextnow terminatec processing and makes only NEXT key active; the specified 
unit Is a main unit 

nextnow UNIT NAME 



nextop, nextlop, backop, backlop specifies the unit executed when the user 
presses the appropriate key; there is no full-screen erase and new 
information is plotted on-the-page; the specified unit is a main unit 



nextlop UNIT NAME 

backop (B) or backop q 



(clears back pointer; disables BACK key) 



help, helpl, data, datal , lab, labl initiates a help-type sequence by 

specifying the unit to be executed if the user presses the appropriate 
^ key; sets the base pointer for the unit to return to unless the base 
pointer is already set; the unit executed is a main unit but not a 
base unit (unless the base pointer is reset to this unit); a help-type 
sequence may be terminated by the -end- command 



help UNIT NAME 
lab (B) or lab 



q (clears lab pointer; disables LAB key) 



^ xj 



helpop, helplop, dataop, datalop, labop, lablop specifies the unit executed 
when the user presses the appropriate key; the unit executed is not a 
main unit or a. base unit and no full-screen erase is performed; 
control is returned to the main unit after execution of the . 
helpop-type unit 

helpop UNIT NAME . 

dataop (B) or dataop q (clears data polnxer; disables DATA key) 

term permits use of the TERM key to initiate a help-type sequence starting 
at the unit containing this command and the specified character 
string; sequence can be terminated by -end- (see -inhibit term-) 

term STRING (maximum of 8 characters) 

term (B) (provides match to any term request that does not 

match an author-specified or system-specified term) 

termq;^ similar to -terra- except initiates a helpop-type sequence 

« 

termop STRING (maximum of 8 characters) 

termop (B) (provides match to any term request that does not 

match an author-specified or system-specified term) 

NOTE: A lesson may have up to 299 -term- and -termop- commands. 

base resets or clears the base pointer in order to alter help-type 
sequencing 

base (B) or base q (clears base pointer) 

base UNIT NAME (sets base pointer to named unit) 

base EXPR,q,NAME,x (example of conditional form; 

argument x leaves base pointer unchanged; argument q 
clears base pointer; maximum of 100 arguments in 
conditional tag) 

end terminates a help-type sequence or a lesson 

end (B) or end help (ends a help-type sequence; may occur 

anywhere in a unit; the user is returned to the base unit 
« after pressing NEXT; -end- is ignored if the user is not 

in a help-type sequence) 

end lesson (when NEXT is pressed after execution of this 

statement, the user is returned to the router lesson or to 
the "Press NEXT to Begin" display; the finish unit is not 
executed; authors are returned to the author-mode display) 
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Timing 



keyllst (non-executable) forms a set of keys with the specified name for use 
with -pause- and rkeytype- commands 

keyllst NAHE,KEYI,KEY2,1CEY3,,,, (from 2 to 7 characters In NA14E) 
keyllst NA1IE,NAMEI,NAME2,,**. (keyllsts may be combined) 

Note: System-defined keyllsts are: 

alpha (letters: a to z and A to Z) 

numeric (digljts: 0 to 9) 

funct (function keys ["key" from o200 to o235]) 

keyset (any keyset Input) 

touch (Input from touch panel) 

ext (Input from external device other than touch panel) 

all (Input from keyset, touch-panel, or exte^al device) 



pause 



delays execution of subsequent commands by the specified Interval 
or until the specified keys are pressed 



pause 
pause 
pause 

pause 



pause 



Note: 



EXPR GIVING NUM SECONDS (minimum of ,75 second) 

0 (causes no pause; exception t6 .75 second minimum) 

(B) ££ pause NEGATIVE VALUE (Interrupts processing 

until any keypress comes In) 
keys-kEYl,KEY2jKEYLIST NAME,.,. (Interrupts processing 

until one of the specified keys comes In; all keynames 

are typed without quote marks and function keys are 

typed In lower case) 
NUM SECONDS, keys»KEYl,KEY2,KEYLIST NAME, ^ (Interrupts 

processing for the spec^^'led time or until- one of the 

specified keys comes In) 

If a function key other than next, such as help. Is specified 
and there Is a preceding -help- or -helpop- command specifying 
a unit to execute, this unit Is executed rather than the 
command following the -pause-. If next Is specified, the NEXT 
key just breaks the -pause-, even If there Is a preceding 
-next- command^ 

The statements -pause keys«touch- and -pause keys-ext- set 
the appropriate -enable-. 



collect allows storage of keycodes .from keyset, touch panel, or external 

Inputs In successive variables, starting at the specified variable; 
Collection terminates with receipt of the specified number of keys 
or with receipt of the TIMEUP key, which is also stored 

collect STARTING VAR,NUM KEYS (must use student variables) 
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getcode stores a user-generated string, left-justified, in the specified 
variable and plots X's; "endkeys" specifies function keys which 
terminate the. entry (in addition to NEXT, which is the default), 
up to 10 characters may be entered and stored 



getcode VAR, endkeys -KEYNAME 1 , KEYNAME 2, .. . (opt) 



(names of keys are 
in lower case) 



keytype 



sets a variable according to the position in a list of the input by 
r.he user; if th« input action is not listed, the variable is set to -I 

keytype VAR,ARG0,ARG1 ,ARG2 , . . . 

arguments ARG0, ARGl, ARG2,... may be any of the following: 



KEYNAME 



(VAR) 
ext(VAR) 



(any keyname; no quotation marks are used; 
function keys are in lower case) 
KEYLIST NAIE (name of a system-defined keylist or of a list set up by 
the —keylist- command) 

(value cf "key" is compared with the value stored in VAR) 
(when the 10th bit from the right of "key" equals 1, 
indicating an external input, the right-most 9 bits 
of "key" are compared with the value stored in VAR) 
touch(COARSE; WIDTH IN CHARACTERS, HEIGHT IN LINES) 
touch(FINEX,FINEY,WIDTH IN DOTS.HEIGHT IN DOTS) 

(COARSE or FINEX,FINEY is the screen position of the lower left 
corner of a rectangle with specified width and height; width 
' and height are optional and are assumed to be 1 if omitted) 



Note: 



Up to 100 keys may be specified; keylists count as one key, 



time presses the TIMEUP key after the specified interval and sets "key** to 
"timeup"; function keys can break through the timing and set key to 
the key pressed 

time EXPR GIVING NUM SECONDS (minimum of .75 second) 

time (B) or time NEGATIVE VALUE (clears any -time- in effect) 

timel specifies a unit in the same lesson to execute (via helpop-type 
sequence) when the indicated time has elapsed; remains in effect 
across other timing commands and across unit boundaries 

timel NUM SECONDS, UNIT NAME (minimum of .75 second) .\ 
timel (B) or tiir.el NEGATIVE VALUE (clears any -timel- in effect) 



timer used 3n a router lesson to specify a unit in the router to which a 
routed user is seat when the indicated time has elapsed 




timer 
timer 



NUM SECONDS, UNIT NAME (minimum of 60 seconds) 

(B) or timer NEGATIVE VALUE (clears any -timer- in effect) 



su 



press puts the specified key into the student input buffer for the 

indicated station, if given; limited to one keypress per second 

press KEYCODE 

press " VAR CONTAINING KEYCODE 

press "KEYNAME" (for non-function keys; lower case only) 
press KEYNAME (for function keys, e*g*, -press next-) 
press KfiiCODE, STATION (presses the key at another station if the 
station is in the same lesson as the -press- command) 

Note: For 2-argcment -press-: - 

zreturn " -1 if the station is in the lesson 
" 0 otherwise 



catchup (no tag) causes a pause in execution while transmission of 
accumulated output to the terminal is completed in order to 
s)mchronize display and execution of commands 

break (no tag) interrupts processing and returns with a new timeslice 
for further processing when a complete timeslice is available 



cpulim specifies the maximum (TPU usage rate in thousand instructions per 
second with a maximum of 10 thousand instructions per second 

cpulim EXPR GIVING MAXIMUM CPU USAGE RATE (maximum of 10) 



130 
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Lesson connections and sections 



ut>e (non-executable) Inserts into the file being condensed the specified 

block(s) from the file specified in the directory OR the file 
specified In the tag of -use-; all contiguous blocks with the same 
name are taken; use codewords on the files must match 

use BLOCK NAME (file is specified in the directory) 
use FILE NAME, BLOCK NAME (multi-file use flag is set in the 
directory; up to 5 different files may be used) 

jurapout cause3 execut:ion of the specified lesson or of the processor lesson, 
if one is declared; up to 10 arguments may be passed to the lesson . 
(see -inhibit jui^chk-, -inhibit from-, and -args--; 

jumpout FILE NAME (goes to the first unit in the lesson; 

jumpout codewords need not match) 
jumpout FILE NAME ( VALUE 1 ,VALUE2) (example of form with arguments) 
jumpout FILE NAME, UNIT NAME (goes to the specified unit in the 

lesson; jumpout codewords must niatch) 
jumpout FILE NAME, UNIT NAME( VALUE) (example of form with arguments) 
jumpout return (returns to the first unit of the lesson from whixsh 

a jumpout was made to the present lesson) 
jumpout return(VALUE) (example of form with arguments) ^ 
jumpout return, return (returns to the lesson from which a jumpout 

was made to the unit following the unit with the -jumpout-) 
jun pout (B) ££ jumpout q (causes a jumpout to the author-mode page 

for authors or to "Press NEXT to begin" page or to a router 

for students or instructors; similar to -end lesson-) 
jumpout <LESLIST POSITION> (causes a jumpout to the first unit of 

the lesson at the specified position in the leslist) 
jumpout <LESLIST POSITION>,UNIT NAME (causes a jumpout to the 

specified unit in the lesson at the specified leslist 

position; jumpout codewords must match) 
jumpout EXPR;FILEM,UNITM;FILE0;FILEl,UNITl;q;x (example of 

conditional form; argument q causes jumpout as above; 

argument x causes no jumpout) 
jumpout resume (used in a router lesson to return the user to the 

lesson and unit specified by the last -restart-) 
' ' Jumpout continue (used In a site lesson to send the user to a 

router or lesson) 

jumpout NOTESFILE NAME (causes j'«mpout to the specified notes file; * 

return to lesson is automatic, via -jumpout return, return-) 
jUmpout notes, choice (causes jumpout with read and write access to 

the student notes file attached to the user's group) 
jumpout notes^read (causes jumpout with read access to the student 

notes file attached to the user's group) 
jumpout notes, write (causes jumpout with write access to the student 

notes file attached to the user's group) 
jumpout notes, instruct (causes jumpout with read access as an 

instructor to the student notes file attached to the group) 
jumpout pnoces (causes jumpout to personal notes) 



(-jumpout- continued on next page) 
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jumpout 80acedlt(LESSON NAME, LIST NAME, TYPE, 'CODEWORD' (opt)) 

(causes -jumpout** to acces8--llst editor; TYPE is -1 to edit 
or 0 to inspect; CODEWORD (or user's editing codeword) must 
match lesson's change or common codeword to edit o£ 
lesson's change, common, or Insfpect codeword to Inspect; 
If the .list contains special options to edit the list, 
these are checked and codewords are Ignored; 
return to the lesson Is via -jumpout return,return(VALUE)-, 
where VALUE Is -1 If the list was changed, 0 otherwise) 

Note: Variable lesson and unit names must be enclosed In parentheses* 



args stores the values of arguments passed by -jumpout- to the lesson; 
values are stored In the specified variables 

args VAR1,VAR2,VAR3 (maximum of 10 variables) 

Note: zreturn » -1 If arguments are passed successfully 
« 0 If no jumpout argiaments 4re present 
> 1 If there are more jumpout arguments present than 
•variables In- -args-; as many values as can be 
received are stored; "2ireturn" value Is the 
actual number of argiaments present 

Argiaments passed by -jumpout- may be picked up by a -unit- 
command with arguments Instead of by -args-. 



from checks the lesson and main unit. If specified, from which a lesson Is 
entered against a list and sets a variable to the relative position 
of the lesson and unit in the list; if no unit is specified, any unit 
in the lesson qualifies; if the lesson and unit are not listed, the 
variable is set to -1; alternate form stores lesson name and unit name 
in the specified variables 



for example: 

from VAR;LESSON0,UNIT0;LESSON1;<LESLIST P0SITI0N>,UNIT2 

(variable lesson and unit names must be enclosed in 
parentheses) 

from VAR FOR LESSON NAME,VAR FOR UNIT NAME (opt) 



lessin checks if the lesson specified is credited to the user's logical site; 
sets "zreturn" to -1 If the lesson is in EM and in use at the user's 
logical site and to 0 otherwise 

lessin 'LESSON NAME' 

lessin (VAR CONTAINING LESSON NAME) 

lessin <LESLIST POSITIOM OF LESSON> 
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in sets "zreturn" to indicate 'whether a user at the specified station 

number is in the lesson containing the -in- command 



in 



EXPR GIVING STATION NUMBER 



Note: zreturn « -2 



-1 



if -in- is in a router lesson and a routed user 
at the specified station is in an instructional 
lesson 

if the station is in the instructional lesson 

containing the -in- command 

if the station is not in the lesson 



notes initiates TERM-comments automatically, or sends the specified text to 
the lesson notes file or student notes file without user interaction; 
the title, if Included, must be left-justified, may contain up to 
15 'characters , and always requires two variable* 

notes STARTING VAR CONTAINING TITLE (opt) (initiates TERM-comments) 
notes STARTING VAR CONTAINING TEXT,NUM VARS,STARTING VAR 

CONTAINING TITLE (opt) ' (inserts text at front of note) 
notes STARTING VAR CONTAINING TEXT,NUM VARS,STARTING VAR 

CONTAINING TITLE (opt), send (sends tlje text automatically) 

Note: Student variables must be used for the texc and the title; 
the format for the text is that for -text- command* 
After multi-argument -notes-, values of **zr8turn** are: 

zreturn « -1 if the note is sent successfully 

« 0 i{ the user pressed BACK! and note was not sent 

« 1 if TERM-comments is not allowed in the lesson 

* 2 if thfe format of the text is incorrect or if the 

text^.is too long (>111 60-bit words or >16 lines) 
» 3 if the note cannot be stored (e«g«, the notes file 

does not exist or is full) 



cstart (non-executable) (no tag) indicates subsequent code is to be 
condensed (used after a preceding -estop-) 



estop (non-executable) (no tag) indicates subsequent code is not to 
be condensed; in effect up to the next -cstart-, if any 



estop* (non-executable) (no tag) indicates none of the subsequent code 
is to be condensed, independent of subsequent -cstart- commands 



NOTE: It is preferable to use the partial condense option of the edicor 
rather than -cstart-, -estop-, and -estop*-. 



ERIC 
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Lesson lists 



lesllst references special blocks containing a list of up to 2400 lessons 

(numbered starting at 0);'lf the -lesllst- command and lesllst blocks 
are In different lessonSi the common codewords must match or the 
codeword argument must be Included; codeword Argument must match the 
. common codeword of the lesson containing the lesllst blocks 

lesllst (0),LESLISX NAME . 
lesllst (zlesson),LESLIST NAME 
lesllst .LESLIST NAME 
lesllst LESLIST NAME 

lesllst LESSON NAME, LESLIST NAME, 'CODEWORD' (opt) 

(LESSON NAME contains the lesllst blocks) 
lesllst <LESLIST POSITION>, LESLIST NAME, 'CODEWORD' (opt) 
lesllst (B) (disconnects the current lesllst) 



/ 



Note: Variable lesson and block names must be enclosed In parentheses. 
Quote marks on the codeword are omitted for variable argument • 

zreturn ■ -1 If the -lesllst- command Is executed successfully 
» 0 If the lesllst blocks are not found 
■ +1 If codewords do not match 



addlst allows addition of a lesson name to a lesllst, either In the specified 
slot or In the first empty slot If none Is specified; the tag must be 
a variable; requires three consecutive variables (the name Is stored 
with: -stores STARTING VAR,30-) 

addlst STARTING VAR,LESLIST POSITION (opt) 



Note: zretum 



-1 if the lesson name is added successfully 

0 if there Is no preceding successful -lesllst- 
command 

1 if the form of tHe lesson name is Incorrect 

2 if the lesson name is already in the lesllst 
(with one-argument form only) 

3 if the lesllst Is full 

4 If the specified slot is occupied (with two- 
argument form only) 

5 if the lesllst is reserved by another user 



removl allows deletion of a lesson at a specified lesllst position; the 
vacated position is left blank 

removi LESLIST POSITION 

Note: zretum ■ -1 if the lesson is removed successfully 

■ 0 if there is no preceding successful -leslist- 
command 

« +1 if the lesllst is reserved by another user 



1 
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reserve reserves the current lesllst to prevent changes via -addlst- and 
•removl- by aore than one user at a time 

^reserve leslist 

f 

Note: zreturn - -2 if the leslist Is already reserved by th.^s user 
*• -1 if -reserve- is executed successfully by this 
user 

■ 0 if there is no preceding successful -leslist- 
command 

• 5+n, where n*station number of the user who has 
reserved the leslist 



release releases the current le^slist (if previously reserved) 
release leslist 

Note: zreturn ■ -2 if the leslist is not reserved by any user 

■ -1 if -release- is executed successfully by this 
user 

" 0 if there is no preceding successful -leslist- 
, command 

" 5+n, where n-station number of the user who has 
reserved the leslist 



Iname stores the lesson name at the specified leslist position in three 
consecutive variables starting at the specified variable 

Iname STARTING VAR, LESLIST POSITION 

Note: Use with -shows- to display the lesson name; e.g.: 
Iname STARTING VAR,LESLIST POSITION 
showa STARTING VAR, 30 

zreturn » -1 if execution is successful 

• 0 if there is no preceding successful -lesliat- 
command 



findl searches the leslist for the lesson name stored in three consecutive 
variables and returns the leslist position in the specified variable 

findl STARTING VAR FOR LESSON NAME, VAR FOR LESLIST POSITION 

Note: If the lesson name is not found or if no leslist is used, 
returned value for the leslist position is -1. 



1 or- 
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Lesson annotation and debugging 



* ' Indicates the statement on that line Is a comment only^ and Is to 
c( space) be Isnored by the compiiter 

*ThxS is adornment, 
c This Is a comment. 



$$ (not a command) when placed on the same line with a TUTOR statement 

Indicates that subsequent material on that line Is a comment 

COMMAND TAG $$thls Is a comment 

I 

change (non*-executable) permits names of commands to be changedf, e.g., to a 
language other than English; also permits symbola (e.g., punctuation) 
to be redefined In- certain judging commands; -change- must be placed 
In the Initial entry unit; all changes are In effect for the entire 
lesson and cannot be altered 

change command NORMAL TUTOR NAME to NEW NAIffi 
change symbol SYMBOLl to SYMB0L2 

I 

for example: 

change command at to wo 
change symbol * to letter 
change symbol ? to puncword 
change symbol p to punc 
change symbol 3 to vowel 
change symbol a to b 
change symbol space to letter 
change symbol sup to null 
change symbol / to dlacrlt 
etc* 

Note: The answer-matching commands affected- by -change symbol- are: 
-answer-, -wrong-, -answera-, -wronga-, -answerc-, -wrongc-, 
7Concept-, -mlscon-, -match-, -storen-. Other commands 
affected are: -getword-, -getmark-, -getloc-, and -compare-. 



step allows a user to step through a lesson command by command; an author ^ 
whose security code matches the lesson's change code may use TERM-step 
(TERM-step is not available for other user types) 

step on 
step off 

step EXPR (value»0 turns off step; valueT^0 turns on step) 



(does not affect condensing or execution) specifies options for 
printing a file; -*list- commands for printing special types of blocks 
must precede those blocks in the program; source blocks and text 
blocks are always printed unless specified otherwise 

nist binary, BLOCK NAME,NU14 WORDS, FORMAT (prints contents of 

binary blocks; see page S20 for information on FORMAT) 
*llst charset (prints contents of all charsets in the lesson 

with 0 for dots on and - for dots off) 
*ll8t charset, (DOTSBLANKS) (prints contents of charsets with 

83rmbols specified for dots and blanks) 
*llst commands, C0MMAND1,C0MMAND2, COMMANDS, (up to 10 commands; 

Msts lines on print where specified commands appear) 
*list common, COMMON NAME,NUM WORDS, FOFMAT (prints contents of 

common; see page S20 for information on FORMAT) 
*list deleted (prints deleted lines [with "mod words" option]) 
*list eject (causes page eject wher^ command is located) 
*list ignore (causes subsequent -*list- commands to be ignored) 
*list info (prints lesson information display) 

*list ~ label, YOUR LABEL INCLUDING SPACES (prints a label at the 

location of the -*list- command) , 
*list leslist (points the contents of all leslists in the lesson) 
*list listing (prints the contents of listing blocks) 
*list micro (prints the contents of all mtcrotables in the lesson) 
*list mods (printe "mod words": first 5 characters of the name of 

the last person to change each line and date of the change) 
*list nosource (stops printing source blocks but not text blocks) 
*list t\otext (stops printing text blocks but not source blocks) 
*],ist off (stops printing blocks at' the location of the command; 

starts printing preceding -*list- options and the unit 

cross-reference table) . . • 
*list off ,^Bl;OCKNAMEl^BLOC^ 

(specifies^tlocics that are not to be printed) 
*list parts (prints only source blocks which are set to condense) 
*list symbols (prints reference table of variables, defined and 

primitive,, used in the lesson) 
*list text (prints only text of -write- and -writec- commands) 
*list title, YOUR TITLE, (specifies subheading to be printed under 

the lesson name on each subsequent page; causes page eject 

when -*list title- is encountered) 
*list vocab (prints contents of vocab blocks) 
*list xref,on (turns on unit cross referencing [and symbol cross 
referencing if requested] for all printed source blocks; 
default case) 
*list xref,all (same as -*list xref,on-) 

*list xref,off (turns off cross referencing for all printed source 
blocks) 

*list xref, parts (turns on unit qross referencing [and symbol cross 
referencing if requested] for all printed source blocks 
which are' set to condense) 

*list 1 space (prints blocks with single spacing; default case) 

*list 2 space (prints blocks with double spacing) 

*list 3 space (prints blocks with triple spacing) 

*list 4 space (prints blocks with quadruple spacing) 



10^ 
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Instructions for printing datasets and namesets are specified in the directory 
of the ,file. Page S20 has Information on FORMAT. 



datasets: 

STARTING RECORD NUMBER, NUM RECORDS, FORMAT ^ 
STARTING RECORD,, special. ^ 

PAGE EJECTS; STARTING RECORD, , special \ 
PAGE EJECTS; special (prints entire dataset in special format with page 

ejects as specified) 
special (prints entire dataset in special format) 

STARTING RECORD,, direct 
• PAGE EJECTS; STARTING RECORD, , direct 

PAGE EJECTS; direct (prints entire dataset in direct format with page 

ejects as specified) 
direct (prints entire dataset in direct format) 

INSTRUCTI0N1;INSTRUCTI0N2; etc. (may state several different instructions) 



namesets: 



NAMES; STARTING RECORD NUMBER, NUM RECORDS, FORMAT 

NAMES; STARTING RECORD, , special 

NAMES;PAGE EJECTS ; STARTING RECORD, , special 

NAMES; PAGE EJECTS; special (prints all records of specified names in 

special format with specified page ejects) 

NAMES; special 

NAMES; STARTING RECORD, , direct 
NAMES;PAGE EJECTS ; STARTING RECORD, , direct 
NAMES;PAGE EJECTS;direct 
NAMES; direct 

INSTRUCTION! ;INSTRUCTI0N2; etc. (may state several different instructions) 



NOTE: PAGE EJECTS may be: pages and/or records (if both are given, the 
entries must be separated by a semicolon, e.g., pages; records). 



With namesets, NAMES may be: 

NAMEl (prints records only for NAMEl) 

NAME1-NAME2 (prints records for names from NAMEl to NAME2) 

NAMEl- (prints records from NAMEl to the last name) 

-NAME2 (prints records from the first name to NAME2) 

omitted (prints records for all names in the nameset; preceding 

semicolon must be included, e.g., ;special or 

; STARTING RECORD, , direct) 




Mote: FORMAT for printing datasets, namesets, commons, and binary blocks: 



ERIC 



Integer or i 
exponential or e 
floating or f 
octal or 
hexadecimal or 
alpha 

X 



o 
h 

or a 



special 



direct 
(DESIGNED) 



or s 



or d 



(nc-varlables; prints 10 words per line) 
(vc-varlables; prints 10 words per line) 
(vc-variab'les; prints 10 words per line) 
(prints 5 words per line) 
(prints 6 words per line) 
(prints 10 words per line) 
(prints each word In o, e, 1, and a formats; 
prints 2 words per line) 

(special format; specified number of words to be printed 
Is Ignored but field must be present; details below) 
(not used with binary blocks) 

(like special format but carriage control Is required) 
(designed format; enclosed in parentheses; details below) 



special format and direct for:?i'Xt; 
words are Interpreted in alpha; 

words with all 0 bits are Ignored unless they are preceded by at least 
one non-zero word on the same line; rt^rtrtx 
a line (and a page) must always end with at least 12 zero bits (oPP^OP) 
up to 127 characters may be printed per line; 

control characters for direct: " single space; "0", double space; 

triple ^pace; overwrite; "1", page eject; "2", bottom of page 

the following print options are placed directly in the dataset, nameset, 
or common; each requires two consecutive words; 



(causes page eject at this location) 
(causes the print of the file or of the name to end 
at this location) 

(causes page eject after each printed page; 
allows top and bottom margins) 
*format records (causes page eject after each subsequent record) 
*format blocks (causes page eject after each subsequent block) 



*format eject 
*format end 

*format pages 



designed format : 

the format is for a line of print; 

format must be enclosed in parentheses; 

up to 135 characters joay be printed per line 

designed format may consist of: 

1 (Integer; nc-varlables; prints 10 characters per word) 

e (exponential; vc-varlables; prints 10 characters per word) 

f (floating point; vc-varlables; prints 10 characters per word) 

0 (octal; prints 20 characters per word) 

h (hexadedm. 1; prints 15 characters per word) 

a (alpha; prints 10 characters per word) 

X (space; preceding number indicates number of spaces) 

1 (location of word; prints 4 or more characters) 

p (skip to next word to be printed on the same line; preceding number 

indicates how many^ words to go forward) 
commas and spaces for readability 1 On 

X .J 
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System variables for sequencing 

args number of arguments transferred at the previous execution of a unit 
with arguments or -jumpout- with arguments 

/ 

' backout " -2 for a single-station baqkout 
« -1 for a general backout / 
« 0 for no backout (e^g. slgnoff via STOPI) 
" +1 after rstatlon stopl- 

/ 

/ 

baseu name of the user's current base unit (« 0 If no base unit Is 

specified, Indicating, the user Is not In a help-type sequence) 



clock value of the system clock In seconds (to the nearest millisecond) 
since the previous deadstart (see command -clock-) 



fromnm lesllst position of the lesson from which the user came via a jumpout 
(» -1 if the lesson is not in the lesllst or if no lesllst is in use) 



key after a keyset input: contains the 7-bit keycode of the last keypress; 

after a touch-panel input; contains a 9-blt number which gives the 
location of the touch square (the binary form of this. number is 
ixxxxyyyy, where the 4 bits labeled "x" give the horizontal touch 
location and the 4 bits labeled "y" give the vertical touch location — 
coordinates for touch squared on the screen are: 0,0 at lower left, 
0,15 at upper left, 15,0 at lower right, 15,15 at upper right); 
after an external input: contains a 10-blt number whose left-most 
2 bits are 10, with the remaining 8 bits carrying information from 
the external source 



lessnum lesllst position of the user^'s current lesson (* -1 if the lesson 
is not in the lesllst or if no lesllst Is being used) 



lleslst maximum number of lessons allowed in the lesllst (' 
is in use) 



0 if no lesllst 



llesson condensed length of the lesson 



malnu 



name of the user'^s current main unit 



mallot memory allotment for theological site at which the user is working 



muse 



total memory usage by users at the same logical site as the user 

Uo 
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nhelpop number of times a help-type key is pressed for on-the-page help; 
ceroed for each main unit and for each arrow in the unit 

proctim processing time in the lesson (in seconds, to nearest millisecond) 

ptime » -1 if the current time is during prime-time hours 
« 0 otherwise 

sitenam name of the user's logical site 

station identification number assigned by the system to a terminal port 
physical site « station $ars$ 5 = int(station/32> 
site station # » station $raask$ o37 = 32x f rac(station/32) 
station =■ 32x physical site + site station // 

tactive number of currently active terminals 

user user type: 'author* , 'instructor* , 'student* , 'multiple* , 

•sabort* (if student records have been aborted), *snockpt* (if 
automatic checkpoint has been aborted) 

usersin number of users in the lesson (routed .users are counted as being in 
the router as well as in the instructional lesson) 

zaccnam name of the account which contains the user's group 



zbatch ^ -1 if the user can submit batch jobs 

= 0 if the user cannot submit batch jobs 

» +1 if batch jobs are turned off for the system 



zcondok =» -1 if the lesson condenses without errors or warnings 

» 0 if the lesson has condense errors or warning messages 



zfroml name of the lesson from which a jumpout was done 
zfromu name of the unit from which a jumpout was done 



zgroup name of the user's group 
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zld unique Identification number for the user; Information Is In 3 fields 

(counting from the left end of the word): 
18 bits: system Identifier 
22 bits: group identifier 
^^0 bits: name identifier 



zlesson name of the user's current lesson 



zpnflle » -1 if the user's group has a personal notes file attached 

~ 0 otherwise (and for multiples and students without access to 
personal notes) 



zpnotes ■ -1 if the user has new, unread personal notes 
^ 0 otherwise. 



zretrnu name of the unit to which -jumpout return, return- will go 



zreturn set by some commands according to the results of execution; set by: 
TUTOR commands: -access-, -addlst-, -addname-, -addrecs-, -attach-, 
-charset-, -chartest-, -checkpt-, -commonx-, -comret-, -datain-, 
-dataout-, -delrecs-, -ext-, -in-, -getline-, -leslist-, -lessin-, 
-lineset-, -Iname-, -micro-, -names-, -notes-, -parse-, -press-, 
-readd-, -readset-,' -recname-, -records-, -release-, -removl-, 
-rename-, -reserve-, -setline-, -setname-, -site-, -station-, -xin-, 
-xout- 



zsnfile " -I if a student user's group has a student notes file attached 
(TERM-comments sent to student notes file) 
0 otherwise (and for authors and Instructors) 
(TERM-comments sent to lesson notes file) 
« +1 if access to student notes and lesson notes is not allowed 



zsnotes ■ -1 if the student has new, unread notes 
» 0 otherwise 



zsysld 60-bit value which uniquely represents the user's PLATO system; will 
not change during lifetime of the system; not for display purposes 



zsystem contains the name of the user's PLATO system 



zterm 



contains the last term requested by the user 
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ztouchx fine-grid x-location of 4the center of the touch box touched 
(« -1 if last input was not a touch input) 

ztouchy fine-grid jr-location of the center of the touch box touched 
(« -1 if last input was not a touch input) 

ztzone contains the three-letter abbreviation of the time zone of the 

location of the central computer of the user's PLATO system (e-g., CST) 



zunit name of the user's current unit 



zusers number 'of users currently signed on 



NOTE: The following system variables contain alphabetic information 
' (left-justified) and must be displayed with -showa-: 
baseu, mainu, sitenam, user, zaccnam, zfroml, zfromu, zgroup, zlesson, 
zretrnu, zsystem, zterm, ztzone, and zunit. 



In addition to the system variables listed in this subsection, keynames of 
function keys may be treated as system constants. These keynames are typed 
in lower case (e.g., next, lab, term) and have the numerical values given in 
the keycode table on page A5. The exception is the SQUARE key, which has the 
keyname "microl**. 



TERMINAL RESIDENT PROCESSING 



Tl 



This section presents features of the pTUTOR programming language available with 
the 'PLATO Programmable Terminal (PPT) and the CDC Information Systems Terminal 
(1ST). Both types of terminals are referred to as "ppt". Features of central 
system TUTOR for running assembly language programs are described although 
details of assembly language are not included • 

Tx\e pTUTOR language is evolving rapid ly, and users should check "aids" for 
current features. ^ 



Loading and running 

/Litutor (non-executable) (no tag) marks the beginning of a terminal resident 
program written in ^TUTOR; all subsequent commands are interpreted as 
^TUTOR commands; must follow the TUTOR part of a program 

unit names and initiates a section of a lesson (called a unit) which may be 
referenced by other sequencing conmiands; must follow a -ptutrr- command 

unit . NAME (maximum of 8 characters in NAME) 

Note: Maximum length of a condensed unit is about 3000 8-bit bytes. 
No unit may be named "q" or "x". 



loadu loads units into the terminal's memory so they can bo executed with 
-runu- or referenced by sequencing commands in pTUTOR; must be placed 
in the TUTOR portion of a program 

loadu NAM£1>NAME2,NAME3 (maximum of 20 units can be loaded) 
loadu , NAME 1,NAME2, NAMES (loads specified units without deleting 

units already loaded) 
loadu (B) (clears flags indicating units are loaded) 

Note: zreturn -1 if units are loaded successfully 

" 0 if the terminal is not programmable or if it 

has the wrong ^TUTOR level 
« 1 if there is not enough memory in the terminal 
" 2 if the units cannot be found 
" 3 if STOP or STOPl is pressed during loading 
« 4 if ;iTUTOR ie not available 
« 5 if there is an error in the binary format 
"« 6 , If too many units are loaded 




\ 



causes execution of a unit which was previously loaded into the memory 
of the terminal (with -loadu-) ; must be placed in the TUTOR portion of 
a program 

runu NAME 

Note: zreturn « -1 if the -runu- is executed successfully 
« 0 if the specified unit is not loaded 



(no tag) terminates execution of the unit which is currently running; 
if no unit is running, -haltu- is ignored; the pTUTOR unit must 
contain a -pause- command in order to be halted; -haltu- must be 
placed in the TUTOR portion of a program 



\ 
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Calculating 



define (non-executable) similar to TUTOR -define- but: primitives (n, v) are 
not used; names of variables, constants, array^, and functions are 
listed, \d.th the number of bits, if necessary; definitions are 16-bit 
signed integer type unless type is specified as 3&loating point or 8-blt 
signed integer; all definitions following a specific type designation 
follow that designation until a different designation is encountered 

for example: 

define NAMEl ,NAME2 »NAME ^ 
NAME4(ARRAYSIZE) 
i,8:NAME5,NAHE6 
FUNC(ARG1 ,ARG2)=EXPR 
f ,48 :NAME7 ,NAME8(ARRAYSIZE) 
i,16:NAME9 

i ,8 :NAME10«NAME9 ,NAME1 1«NAME9 
NAME12*20,NAME1>4.3 

Note: Defined names loay contain up to 7 characters and must start 
with a letter. 

Up to 6 arguments are permitted in defined functions. 
One-dimensional arrays are permitted. 
Approximately I(^3j9 definitions are permitted. 




calc assigns the value of the expression on the right side of the assign 

arrow to the variable on the left side (available functions are given 
on page 17) 

calc VAR^" EXPR 

calc VAR^ "L?;TTER" (single character only; character code is 
placed i.: the rightmost 8 bits of VAR of integer type) 

calcc does one of several calculations depending on the rounded value of 
a conditional expression 

calcc EXPRjVARl^* EXPPii,VAR2<> FrPR0,VAR3« EXPkl , ,VAR44' EXPR3 



calcs sets a variable to one of several values depending on the rouuded 
value of a conditional .expression 

calcs EXPR,VAR« SXPRM,EXPR0,EKPR1 ,EXPR2 , ,EXPR4 



NOTE: With -calcc- and -calcs- a blank tag entry (^,) means no calculation is 
done for the corresponding value of the conditional expression. 
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zero sets to zero a single variable or consecutive variables 

• zero VAR 
zero STARTING VAR,NUM VAfiS 
zero (B) (sets all defined variables to 0) 

Note: In the 2-argument form, the number of bits zeroed Is determined 
by. the type designation of STARTING VAR. 

set sets valties of consecutive variables starting at the specified 

variable, or sets values of consecutive array elements starting at 
the specified element 

set STARTING VAR« EXPR1,EXPR2,EXPR3,... (up to 95 values) 
Note: All variables must be the same type as the stairtlng variable. 

* 

compute evaluates a character string containing a simple expression Involvl-.g 
constants and converts the string to a number 

compute VAR FOR RESULT, STARTING VAR OF STRING, NUM CHARACTERS 

Note: The string may contain up to 128 characters. 

zreturn » -1 if the string is converted successfully 

« 0 if there are operatloas in the string when 

* -specs noops- is in effect 

» 1 if the string contains an invalid character 

» 2 if there too many decimal points 

« 3 if the expression is too complicated 

« 4 If there is an unrecognized operator 

« 5 if the expression has bad form 

/ » 6 if there are unbalanced parentheses 

randu selects a random number, sampled with replacement, and places it in 
the specified variable \ 

randu VAR, MAXIMUM (selects integer from 1 to MAXIMUM; 

0 i MAXIMUM i (2l^ - 1) ) 

Note: If the number generated is larger than the specified variable 
type can store, only the rightrmost bits are retained* 

setperm creates a permutation list of the specified length for sampling by 

the -randp- command (similar to the two-argument -setperm- in TUTOR) 

setperm LIST LENGTH,STARTING VAR OF LIST (first variable of the list 
contains the number of Integers remali»lng in the Us^: ^-^'^h 
remaining variable contains one bit for each Integer) 



ERJC , U7 
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randp select? an Integer without replacement from the list set up by 

-setperm- and places It In the specified variable; when the list Is 
exhausted, the variable Is set to 0 

randp VAR FOR STORING VALUE, STARTING VAR OF PERMUTATION LIST 



remove removes the specified value from the permutation list 

remove INTEGER TO REMOVE, STARTING VAR OF PERlflJTATION LIST 

restore restores the specified value to the permutation list 

restore INTEGER TO RESTORE, STARTING VAR OF PERMUTATION LIST 



block copies consecutive variables from one location to another (similar to 
the TUTOR form of -block- except that there are no central memory 
variables) 

block FROM STARTING VAR,TO STARTING VAR,NUM VARS 

Note: The number of 8-blt bytes copied is determined by the type 
designation of the "from" variable. 



find searches each variable in a list of consecutive variables for the 
first occurrence of the specified object 

find ARGl ,ARG2 ,ARG3 ,ARG4 

ARGl « variable containing the object bit pattern 

ARG2 - starting variable of the^ list (variables in th: list 

must be the same type as the object) 
ARG3 « number of variables in the list 

A nr» A J -^Ul ^ ^.^4 *• 1 ^ «. J t-U^x «- 

m\U*t " VCta. XCXUJLO JLXJK Oi.Ui.Xlt5 UltO JLVI\«OUJLVIt» VTJL UAAC WjC\«w 

(0 if found in first variable, 1 if found in second 
variable, etc., -I if the object is not found) 



pack packs a character string starting in the specified variable; packs 
each 6-bit character code into one 8-bit byte; string may contain 
embedded -show- and -showa- 

pack STARTING VAR FOR STORING STRING^VAR FOR STORING 
CHARACTER COUNT (opt) ^STRING 
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search searches a buffer for the first occurrence of the specified character 
string (each character occupies an 8-blt byte) 

search ARGl ,ARG2 ,ARG3 ,ARGA ,ARG5 »ARG6 

' ARGl « starting variable containing the object string to be 

searched for 

ARG2 « number of 8-blt bytes In the object string 
ARG3 « starting variable of the buffer to be searched 
ARG4 " number of 8-blt bytes In the buffer to be searched 
ARG5 « relative character position In the buffer at which to 

start the search 
ARG6 » variable for storing the relative location of the object 
(0 If found In the first 8-blt byte, 1 If found in the 
second 8-blt byte, etc., -1 if not found) 



searchf searches a buffer for the first occurrence of a character string in 
a specific field vdthln an object 

searchf ARGl , ARG2 ,ARG3 ,ARG4 ,ARG5 ,ARG6 ,ARG7 ,ARG8 

ARGl « variable whicij^ contains the first character of the 

•string to be fcJund 
ARG2 » number of 8-bit bytes in the string 
ARG3 = starting, variable of the buffer to be searched 
ARG4 « number of entries in the buffer to be searched 
ASG5 « entry in the buffer at which to start searching 
ARG6 = number of 8-blt bytes in each eatry in the buffer 
ARG7 « starting byte position within each entry for comparison 

with the string 

ARG8 « variable for storing the relative position of the object 
(0 if found in the first entry, 1 if found in the second 
entry, -1 if not found) 



lid 
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Operations, symbols, and functions used In calculations 

addition + 
subtraction - 
multiplication x or * 
division ^ or / 

exponentiation ** 

parentheses and brackets ( )i ( ]i { } 
assignment of a value to a variable ^ 
designation of an octal constant o 

° « degree sign; Indicates a number Is Interpreted In degrees 
TT - pi - 3a4l59**. 
e « 2.71828..* 

bit operations: $mask$, $unlon$r. $dlff$, $ars$, $cls$ 
logical operations: <, >, ^, =», j^, $and$, $or$. 



abs(X) absolute value of X 

^nt(X) Integer part of X 

frac(X) fractional part of X 

log(X) cottmon logarithm of iX (base 10) 

. alog(X) colimon antllogarlthm of X (I.e., 10^) 

\ln(X) natural logarithm of X (base e) 

e^p(X) e^ 

sln(X) sine of X, X In radians; use sln(X^) for X In degrees 

cos(X) cosine of X, X In radians; use cos(X^) for X In degrees 

comp(X) one's complement of X (bit reversal) 

zvloc(X) absolute memory location In RAM of the variable X 



zk(KEYNAME) returns keyset code for KEYNAME (e.g., zk(m), which has value 77; 

KEYNAME must be specified; expression is not allowed; allowed^ 
keynames are given In the appendix, In the keycode table for 
programmable terminal) 

Ntimbers are represented In "two's complement" form; I.e., -X « corap(X)+l . 

The left-most bit of an Integer Is the sign bit. 

Range of values for 8-blt Integers Is -2^ to +(2^ - 1), or -128 to +127 . 
Range of values for 16-blt Inte'gers Is -2^5 to +(2^5 - i), or -32768 to +32767 

Floating point numbers contain 48 bits: 

left-most bit is the sign bit; 

next 15 bits contain the exponent; 

right-most 32 bits contain the coefficient. 
Values of floating point numbers range f rom. ±2'~16384 to ^2+^^383 , 
Floating point numbers ha/e up to 9 significaat digits. 

Tolerance with floating point operations (<, >, <, ^, », ^, int, frac) 
is 2^2^ relative error (approximately 1.5xl0""8 relative error). 



File operations 



attach establishes a connection betweei^ a pTUTOR lesson and a dataset which 
Is stored on a flexible disk connected to the tgrmi^al 

attach NA^fE (variable tag must be an integer variable and must be 
' enclosed in parentheses) 

Note: zreturn « -1 If connection to the file is successful 

« 0 if the dai:a5Gt i's not found on the flexible disk 
-M if there is 'a disk error 



data in transfers data from the dataset to the specified buffer 

dataln STARTING RECORD NUMBER, TO STARTING VAR^NUM RECORDS 

dataout transfers data from t^& specified buffer to the dataset 

dataout STARTING RECORD NUMBER, FROM STARTING VAR,NUM RECORDS 

NOTE: With -dataln- and -dataout-: 

zreturn « -1 if the transfer is successful 
0 if no dataset is attached 
= +1 if there is a disk error 

Each record of a pTUTOR dataset contains 128 8-blt bytes. The receiving 
or sending buffer must accommodate the records received or sent. 
From 1 to 255 records may be transferred* "^^^^^^ 

file performs operations on a flexible disk attached to the terminal 

file create;dataset,NAME,NUM RECS ,DISKUNIT (creates a dataset) 
file destroy; dataset, NAME, DISKUNIT (destroys a dataset) 

Note: DISKUNIT is 0 or !• 



zreturn »= 


-1 


if the operation is successful 


S3 


1 


if there is an error in reading the disk 


» 


2 


if there is an error in writing to the disk 




3 


if there is a system error 


a 


4 


if the disk unit does not respond to the terminal 




5 


if the file is not found (with, "destroy" option) 


zs 


6 


if this is a duplicate name* (with "create" option) 




7 


if the disk unit number is Illegal 


sx 


8 


if there is insufficient space for another file 


■ 




(wfth "create" option) 


9 


if the disk format is bad 




10 


if there is a system error 




11 


if there is a system error 
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Judging 

darrow (non-executable) establishes a buffer (starting variable and length) 
for all subsequent -arrow- commands; if omitted, the buffer must be 
specified with the -arrow- command 

darrow STARTING VAR,NUM CHARACTERS ALLOWED 



arrow places an arrow on the screen at the specified location and stores 
characters in the specified buffer; indented commands which follow 
-arrow- are executed before processing stops to wait for student 
input; non-indented commands which follow these indented commands but 
V which precede response-matching commands are executed each time a 
judging key is pressed to initiate judging 

^ arrow LOCATION; STARTING VAR,NUM CHARACTERS ALLOWED 

(LOCATION may be COARSE or FINEX,FINEY) 
arrow LOCATION (buffer established by preceding -darrow^) 



endarrow (no tag) must terminate response processing; if the response is 

matched, indented commands followitig the matched response and indented 
commands following -ifmatch- are executed; if the "wrong" response is 
matched ojr if the response is not matched, judgment is "no" and 
processing stops until another response is entered; if judgment is 
"ok", response processing is complete and commands following -endarrow- 
are executed 



long modifies the maximum number of characters allowed at an arrow set by 
the -arrow- command or the -darrow- command; cleared at each -arrow- 
long NUM CHARACTERS 



force alters the input of a response as specified; must appear as an 
indented command following -arrow-; cleared at each main unit 

force long (initiates judging when the number of characters 

Xntered reaches the limit set by -long-) 
force font (inserts the font code before the first keypress) 
force (B) (clears the current settling of -force- in this unit) 



jkey 



specifies keys (in additiop-^ NEXT) which will initiate judging; 
cleared at each -arrow-'; JCf a non-function key is specified, it 
appears as the last key J[n the response buffer; names specified in 
the -keylist- command ai/e permitted, including system-defined keylist 
names 



jkey KEY1,KEY2,KEY3 (e.g., jkey back,»^ ) 
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copy activates CX)PY Vey and specifies a buffer containing characters to be 
vnritten on the screen one^-wqrd at a time when COPY is pressed; loads 
the string into the response Bliffer exactly as It appears on the 
screen; cleared at each -arrow- 

• copy STARTING VAR,NUM CHARACTERS 

putd replaces a character string in the response buffer with another 

character string; the first character in the tag is interpreted as 
the separator l)etween strings 

putd /STRING1/STRING2/ (separator is /) 
putd ,SriaNGi,STRING2, (separator is ,) 

' Note: zreturn « -1 if -putd- Is executed successfully 

« 0 if the replacement string causes the tesponse to 
be longer than the storage buffer 

specs modifies standard judging procedures for all subsequent answer 
processing at that arrow; cleared at each -arrow-; settings are 
cumulative at an arrow; cleared at each -arrow- 
specs nomark (prevents default answer markup) 
specs nookno (prevents appearance of "ok" and "no") 
specs noops (prevents use of mathematical operators in a 

numerical response) 
specs nospell^- (tx|rns off default spelling checks; no spelling 

markup is done; "zspell" is not set) 
specs okcap (allovs capitalized word in the response to match a 
non-capitalized word in the tag of a response- 
matching command) 
specs okextra (allows "extra" words in the response^ i.e., words 

not in the tag of the response-matching command) 
specs okspell (allows any reasonable spelling of words in the 
response) 

specs punc (allows only punctuation specified in the response- 
matching command; without -specs punc-, specified 
punctuation must be present, but additional 
punctuation may also be present) 

specs (B) (clears previous settings at this arrow) 

specs nookno, okcap, okspell (may combine tags) 

\ 

NOTE: With the following response-matching commands (-keyword-, -answer-, 
-wrong-, -answerc-, -wrongc-, -exact-, -exactw-, -ansv-, -wrongv-), 
if the response matches the tag or the required argument, subsequent 
indented commands are executed up to the next non-indented command • 
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keyword checks the response for words listed in the ta^; if a word is matched, 
the variable is set to the relative position of the first matched word 
in the tag and judgment is "ok" ("zjudged" -set to --1); if no word is 
matched, the variable is set to -1, judgment is not made, and judging 
continues 

keyword VAR|woRD0^[WORD1 SYNONYM1]|woRD2^|WORD4 

answer compares the response with the -answer- tag; checks for spelling, 

capitalization, extra words, and punct;uation unless altered by -specs-; 
punctuation marks -are treated as words; sets "zjudged" to -1 if the 
response matches the tag 

answer <EXTRA WORDS> [SYNONWIS SEPARATED BY SPACES] W0RD2 W0RD3 

(blank tag matches a response in which nothing is entered 
or which contains only spaces and punctuation; 
-allow blanks- must be in effect) 

answer < a, STARTING VAR,NUM CHARACTERS> (maximum of 10 words) 

Note: Punctuation symbols are ,.?!;:"/ 

wrong similar to -answer- but for an incorrect response; sets "zjudged" to 0 
if the' response matches the tag 

wrong <EXTRA WORDS> [SYNONYMS SEPARATED BY SPACES) W0RD2 W0RD3 
wrong < a, STARTING VAR,NUM CHARACTERS> (maximum of 10 words) 

answerc conditional form of -answer-; performs checks available with -answer-; 
sets "zjudged" to -1 if the response matches the required argument 

answerc EXPR^RESPONSEM|iRESPONSE0|^RESPONSE2 

wrongc similar to -answerc- but for an incorrect response; sets "zjudged" to 0 
if the response matches the required argument 

" wrongc EXPR^RESPONSEMfRESPONSE0|RESPONSEl||RESPONSE3 

exact compares the response with the tag for an exact character by character 
match; sets "zjudged" to -1 if the response matches the tag 

exact STRING (blank tag matches a response in which nothing is 
entered; -allow blanks- must be in effect) 

exactw similar to -exact- but for an incorrect response; sets "zjudged" to 0 
if the response matches the tag 

exactw STRING ' 
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ansv checks a numerical response against the first argument In the tag, 
with tolerance set by the optional second argument; sets 
"zjudged" to -1 If the response matches the tag within the tolerance; 
tolerance may be stated as absolute deviation or percent deviation; 
if tolerance is omitted, the response value must match the tag value 

ansv VALUE, TOLERANCE (opt) 



wrongv similar to -ansv- but for an incorrect numerical response; sets 

"zjudged" to 0 if the response matches the tag within the tolerance 

wrongv VALUE, TOLERANCE (opt) 



ok judges a response "ok" and sets "z judged" to -1 if the rounded value 

of the tag is negative; if the judgment is "ok", indented commands 
following -ok- are executed • 

I ok EXPR (blank tag#ls equivalent to negative value) 



noi judges a response "no" and sets "z judged" to +1 if the rounded value 

of the tag is negative; if the judgment is !'no", indented commands 
following -no- are executed 

no EXPR (blank tag is equivalent to negative value) 



or (no tag) placed on the line between response-matching commands to 

provide alternative responses; if the tag of any command linked by 
-or- is matched, indented commands following the last linked' 
response-matching command are executed 



ifmatch (no tag) indented commands following -ifmatch- are executed whenever 
a response is matched, .independent of judgment ("zjudged" equals -1 , 
0, or +1); only one -ifmatch- may occur for each -arrow^; -ifmatch- 
must be the last non-indented command before -endarrow- 



iarrow specifies the unit to be executed immediately after each subsequent 

-arrow- in a main unit; equivalent to indented -do- command after the 
-arrow- command; cleared at each main unit; later occurrence in the 
unit overrides an earlier setting in the unit 

iarrow UNIT NAME 

iarrow EXPR,UNITM,UNIT0,x,q,UNIT3 (example of conditional form) 
iarrow q (clears previous setting in the unit) 
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ijudge specifies the unit to be executed each time the student presses a 
judging key; equivalent to non-indented -do- command after -arrow- 
following indented commands but preceding response-matching commands; 
cleared at each main unit; later occurrence in the unit overrides an 
earlier setting in the unit 

Ijudge UNIT NAME 
, ,i judge EXPR,UNITM,UNIT0,q,UNIT2,x (example of conditional form) 
ijudge q (clears previous setting in the unit). 

judge alters the judgment rendered by judging commands 

judge ok (sets judgment to "ok"; sets "z judged" to -1; 

executes subsequent commands up to the next judging 
or non-iudented command before branching to -ifmatch- 
[or -endarrow-] ) 

judge no (sets judgment to "no" [unantlciMted] ; sets 

"z judged" to +1; executes subseqi^nt commands up to 
the next judging or non-indented command before 
branching to -ifmatch- [or -endarrow-] ) ; returns to 
the arrow for additional input) 

judge wrong (sets judgment to "no" [anticipated]; sets 

"z judged" to 0; executes subsequent commands up to 
the next, judging or non-indented command before 
branching to -ifmatch- [or -endarrow-] ) ; returns to 
the arrow for additional input) 

judge okquit (sets judgment to "ok"; sets "z judged" to -1; 

branches tc -ifmatch- [or -endarrow-]) 

judge noquit (sets judgment to "no"; sets "z judged" to +1; 

branches to -ifmatch- for -endarrow-] ; 
returns to the arrow for additional input) 

judge quit (does not alter judgment or "z judged"; branches to 
-ifmatch- [or -endarrow-]; allows the student to 
leave the arrow even if judgment is not "ok") 

judge exdent (sets "z judged" to 2; branches to next non-indented 
command and continues judging) 

judge exit (returns to the arrow to wait for additional input) 

judge ignore (stops processing, erases response, and returns to 
the arrow for additional input) 

judge X (leaves judgment unchanged; used in conditional form) 

judge EXPR,no,ok,x,wrong (example of conditional form) 

okword changes "ok" message to the character string in the specified buffer; 
each character is in an 8-bit byte 

okword STARTING VAR,NUM CHARACTERS (may be blank) 



noword changes "no" message to the character string in the specified buffer; 
each character is in an 8-bit byte 



noword STARTING VAR,NU11 CHARACTERS (may be blank) 
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getmark used after judging a response to give markup Inforaatlon on 
individual words Xn the response 

getmark ARG1,ARG2 

ARGl « relative position of the word in the response 
(first word is 1, second word, 2, etc*) 

ARG2 = variable containing markup infdrmacion (must be ? 6-bit 
integer variable) 

-2 if the response is perfect or if no markup is done 
with the response-matching command used 
= -1 if the position of the word is out of bounds 

(i.e., if ARGl > "zwcount") 
=s 0 if there are no errors in the word 
> 0 bits in ARG2 are set according to the error(s), 
starting at the right-most bit (subscript "2" 
indicates the number is in binary notation): 
(I2) a word preceding this word is missing' 
(102) the word is out of order <too far right) 
(1002) there is a capitalization error 
(1 0^02) spelling is incorrect 
(10 0002) (bit not currently set] 
(100 0002) the word is an extra word 
(1 000 0002) this word is the last word, and a 

word which should follow is ralss-ing 



getloc gives the screen position of the beginning (and end, if requested) of 
the specified word in the response 

getloc ARG1,ARG2,ARG3,ARG4 (opt),ARG5 (opt) 

ARGl = relative position of the word in the response 

(first word is 1, second word, 2, etc.) 
ARGl ^ variable for storing the finex screen position of 

the beginning of the word (= -1 if ARGl > "zwcount") 
ARG3 « variable for storing the finey screen position of 

the beginning of the word 
ARG4 « variable for storing the finex screen position of 

the end of the word (optional) 
ARG5.= variable for storing the finey screen position of 

the end of the word (optional) 
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Presenting 



write displays text, including embedded infonnation 

write MESSAGE, INCLUDING EMBEDDED INFORMATION 

writec displays one of several messages, depending on the value of the 

conditional expression; the conditional expression must conform to 
restrictions on calculations 

writec EXPR^MESSAGEM^MESSAGE{;|MESSAGE1^^MESSAGE3 



NOTE: The following embed features are available. See descriptions of the 
individual commands for definitions of the arguments. 



< show ,EXPR> or < s ,EXPR> 

< showt ,EXPR,LEFT,RIGHT> or 
<showb,EXPR,NUM BITS> or 
<6howo,EXPR,NUM PLACES> or 
< showh,EXPR,NUM PLACES> or 
<showa, STARTING VAR,COUNT> 



<at,COARSE>; < at,FINEX,FINEY> 
<atnm,COARSE> ; < atnm, FINEX,FINEY> 



<t,EXPR,LEFT,RIGHT> 
<b,EXFR,NUM BITS> 
<o,EXPR,NUM PLACES > 
<h,EXPR,NUM PLACES > 
or < a, STARTING VAR,COUNT> 



show 



displays the value of s?n integer variable or expression 



show EXPR 



showt displays the value of a variable or an expression in the specified 
format 

showt EXPR, PLACES LEFT OF DECIMAL , PLACES RIGHT OF DECIMAL 

(format, if omitted, is 4,3; if third argument is omitted, 
no places are shown to the right of the decimal) 



showb displays the value of an integer variable or expression in binary 
notation; displays the specified number of bits, counting from the 
right end of the value 



showb EXPB,NUM BITS 
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showo displays the value of an integer variable or expression in octal 

notation; displays the specified number of places^ counting from the 
right end of the value 

showo EXPR,NUM PLACES 

is- 
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shovh displays the value of an Integer variable or expression In hexadecimal 
notation; displays the specified number of places > counting from the 
right end of the value 

showh EXPR,NUM PLACES 

showa displays characters In the specified Integer varlable(s), reading from 
the left end of the buffer; eacii character Is in an 8-blt byte 

showa STARTING VAR,NUM CHARACTERS 



erase erases the screen, selectively or entirely 

erase (B) (causes full-screen erase) 

erase NUM CHARACTERS TO ERASE 

erase NUM CHARACTERS PER LINE, NUM LINES 



mode 



specifies terminal writing mode (see system variable "zmode") 



mode write (normal writing state; writes selected dots) 
mode erase (erases selected dots) 
mode rewrite (erases and rewrites in one step) 
mode Inverse (displays dark characters on light background) 
mode EXPR, erase, write, X, Inverse (example of conditional form; 
argument x leaves writing mode unchanged) 



size specifies size bold-face or normal writing o£ sets size for 
relocatable commands (-rdraw-, --rdot-, etc.) 

size SIZE (does not affect writing) 

size SIZE IN X DIRECTION, SIZE IN Y DIRECTION 

size bold (specifies bold-face writing) 

size 0 o£ size (B) (restores standard writing) 

rotate specifies vertical or normal writing 0£ sees angle for relocatable 
connnands (-rdraw-, -rdot-, etc*) 

rotate ANGLE IN DEGREES (does not affcjct writing) 

rotate vertical (plots writing from bottom to top of screen) 

rotate 0 or rotate (B) (restores writing from left to right) 



tabset specifies 10 tabulator settings which are used when the student 

presses the TAB key; each setting is an 8-bit byte which gives the 
horizontal character position on the scrfeen; settings remain in effect 
until reset by another -tabset- command 
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tabset STARTING VAR 

tabset (B) (clears previous -tabset- settings) 
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text displays contents of an alphanumeric buffer line by line; the end of 
a line must be Indicated by an 8-blt byte equal to 0; not affected by 
-size- or -rotate- 
text STARTING VAR,NUM 8-BIT BYTES 



textn similar to -text- except lines of text are numbered to the left of 
each line; not affected by -size- or -rotate- 

textn ARGl ,ARG2,ARG3,ARG4,ARG5,ARG6 ^ 

ARGl- ^"Starting variable of the buffer 
ARG2 = number of 8-blt bytes , 

ARG3 « variable for storing the position of the next character 
to be plotted (1 + position of last character displayed) 

ARG4 = number of the first line displayed (If equal to 0*, no 
text Is displayed) 

ARG5 « number of the last line displayed (maximum Is 31) 

ARG6 « maximum number of characters per line 



Note: zreturn = -1 If ARG4 and ARG5 are in the range 0 to 31 
= 0 otherwise 



gfill similar to -fill- but^fllls a rectangle relative to the -gorlgln- 

locatlon; affected by preceding -scalex- and -scaley-; not affected 
by -size- and -rotate- (see -fill-) 

gflll CORNER LOCA'i' ION; OPPOSITE CORNER LOCATION 



charllm (non-executable) specifies the highest character number into which 
alternate font characters may be loaded by -char- or -charset-; if 
omitted I 128 slots are set aside In memory for storing characters 

charllm NUMBER (values from 0 to 127) 



charset loads a character set Into the terminal's memory from the flexible 
disk connected to the terminal 

charset LESSON NAME, BLOCK NAME (variable arguments must be enclosed 

In parentheses) 

Note: zreturn « -1 if the charset is loaded successfully 

a 0 if the charset is not found on the flexible disk 
« +1 if an error occurs in reading the flexible disk 
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char permits specification of specially designed characters for display 

char NAME ,ARG1 , ARG2 , ARG3 , ARG4 ,ARG5 , ARG6 , ARG7 , ARG8 
char NAME, STARTING VAR 

Note: In the 9-argument form, ARGl through ARG8 specify which of the 
16 dots are lit in each of the 8 columns of the character. In 
the 2-argument form, STARTING VAR is the first of 8 consecutive 
16-bit variables, each specifying tha dots in each of the 
8 columns, as in the g^-argument form. 
NAME may be a character number or a defined name. 

getchar copies the depiction of the specified character into the specified 

buffer (8 consecutive 16-bit integer variables or 16 consecutive 8-bit 
integer variables); one ^column of the character is ia each 16 bits 

getchar NAME, STARTING VAR 

Note: NAME may be a character number or a defined name. 



inhibit disables certain actions of pTUTOR in a unit; settings are cleared 

at eech main unit and default settings are restored; effect within a 
unit is cumulative, i.e., later occurrence of -inhibit- is added to 
the effect of an earlier occurrence 



inhibit arrow 
inhibit blanks 

inhibit erase 

inhibit keys 
inhibit pUito 
inhibit (B) 



(prevents plotting of the response arrow) 

(prevents judging if a judging key is pressed before 

a response is entered; default setting) 

(prevents normal full-screen erase when proceeding to 

a new main unit) 

(prevents any keypress from breaking through -pause-) 
(prevents processing of output from the central system) 
(establishes the default settings in this main unit; 
equivalent to: -allow arrow, erase, keys, plato- and 
-inhibit blanks-) 



allow permits actions which have been inhibited in the unit by -inhibit-; 

effect within a unit is cumulative, i.e., later occurrence of -allow- 
is added to the effect of an earlier occurrence 

allow arrow (allows the response arrow to be plotted) 

allow blanks (allows null input at a response arrow; default" !•> 

-inhibit blanks-) 
allow erase (allows a full-screen erase at a new main unit, 
allow keys (allows input from the keyset to break through -pause-) 
allow plato (allows processing of output from the central system) 
allow (B) (establishes settings opposite to default settings; 

equivalent to: -inhibit arrow, erase, keys, plato- and 

-allow blanks-) 
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xout sends data (in 8-bit bytes) contained in the specified variables to 
an external device; data is read starting with the left-most byte 

xout DEVICE ADDRESS, STARTING VAR,NUM 8-BIT BYTES TO SEND 



xin collects data (in 8-bit bytes) from an external device and stores it 

in the specified variables starting at the left-most 8-bit byte 

xin DEVICE AD DRESS, STARTING VAR,NUM 8-BIT BYTES TO STORE 



NOTE: See descriptions in "aids" of TUXOR versions of -xout- and -xin- for 
current infoinnation on device addresses* 



intrupt specifies a unit to execute (via -do-) when an interrupt is received 
from an external device 

intrupt UNIT NAME 

intrupt EXPR,NAMEM,NAME0,x,NAME2,q (example of conditional form) 



NOTE: The following commands have similar forms to their TUTOR counterparts 
with exceptions as noted: 

-at-, -atnm-, -circle-, -circleb-, -draw-, -dot-, -box-, -plot-, -fili- 
A -vector-, -enable-, -disable-, -play-, -record-, -slide-, -beep-. 

g raphing commands : -gor igin- , -axes- , -bounds- , -seal ex- , -scaloy- , 
-labelx, -labely-, -markx-, -marky-, -gdot-, -gdraw-, -gbox-, -gat-, 
-gatnm-, -vbar-, -hbar-, -gvector-, -gcircle-. 

With graphing commands: -labelx- and -labely- require an explicit 
format for the labels in the same format as -showt-. 

There are no default values for -gorigin-, -axes-, -bounds-, -scalex-, 
and -scaley-. These parameters must be set explicitly. 

relocatable commands: -rorigin-, -rat-, -ratnm-, -rdot-, -rdraw-, 
-rcircle-. 



Display commands use "zwherex" and "zwherey" as current screen position 



Exchanging information with the central system 



xmit permits exchange of data between the terminal and the central system; 
when -xmit- is in the TUTOR part of a program, data is sent to the 
terminal for use in a /iiTUTOR program; when -xmit- is in the pTUTOR 
part of a program, data is sent to the central system for processing 
in a TUTOR program 

;uT';TOR fora (sends an 8-bit value to the central system, where it 
is processed as an external key, i.e.^ a key from an 
external device (to pick up data from a single -^mit-, 
-pause keys»ext- and processing of "key" must follow the 
-runu- command; to pick up data from any number of -xmit- 
commands, -enable ext- and -collect- must follow -runu-]) 

e xmit EXPR 



TUTOR form (data is in the form of horizontal segments; byte size of 
data ^16; number of 8-bit bytes received is in "zdata"; 
the data is picked up by the /iTUTOR program by the 
—receive- command) 

STARTING VAR,NUM SEGMENTS , SEGMENT SIZE (opt) 

(SEGMENT SIZE, if omitted, is 60; if SEGMENT SIZE > 16, 
only the right-most 16 bits are sent) 

After the TUTOR -xmit-, 

zreturn » -1 if the data is transmitted successfully 
« 0 if no pTUTOR program is loaded 
= +1 if the STOP key is pressed during transmission 



receive collects data that is sent to the terminal from the central system 
(by -xmit-) 

receive STARTING VAR,NUM 8-BIT BYTES 

Note: If the byte size for data transmitted from the central system 
is > 8, the byte size for the receiving buffer must be 16* 



sendkey sends a key value to the central system (-pause- must be present to 
accept the key) 

sendkey (B) (sends the current value of "zkey") 
sendkey stop (sends the STOP key) 



xmit 



Note: 
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traps output from the ceatral system in the specified buffer; executes 
the trapped output; traps status of the terminal 

trap save;STARTING VAR,NUM 8-BIT BYTES (traps output) 

trap play; STARTING VAR,NUM 8-BIT BYTES (executes trapped output) 

trap status; STARTING VAR,NUM 8-BIT BYTES (saves terminal status 

seen by the central system; saves 27 bytes) 
crap terming; Starting VAR,NUM 8-bit bytes (saves terminal status 

seen by the ;iTUTOR executor; saves 27 bytes) 
trap save, play; STARTING VAR,NUM 8-BIT BYTES 

(save^ and executes trapped output) 

Note: zreturn « number of 8-bit bytes trapped in the buffer 
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Routing 

lesson sets the system variable "zldone" to indicate whether a lesson is 
considered complete 

lesson complete (r>et8 "zldone" to -1) 
lesson incomplete (sets "zldone" to 0) 
^ lesson no end (sets "zldone" to +1) 

lesson EXPR, complete, incomplete, X, no end (example of conditional 
form; argument x leaves "zldone" unchanged) 

score places the value of the tag, rounded to the nearest integ^, into the 
system variable "zscore" 

score EXPR (value from 0 to 100) 

score (B) ££ score NEGATIVE VALUE (sets "zscore" to -1) 



i U ,J 
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Sequencing 
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jampn jumps to the specified unit but does not do any initializations, 
such as main unit, screen erase, etc.; ^ears the -do- stack 

jumpn UNIT NAME 

jumpout causes immediate execution of the specified lesson on the .flexible 
disk connected to the terminal 

jumpout LESSON NAME , (variable tag must be an integer variable and 

must be enclosed in parentheses) 
jumpout (B) (returns to the router lesson on the flexible disk) 

press puts the specified key into the student input buffer 
•« 

press LETTER (e.g. , "-press b-) 
press (zk(LETTER)) 

press FUNCTION KEY (use lower case, e.g., -press next-) 
press (EXPR) 

getkey (no tag) reads th^ next key from the key buffer (which contains up to 
12 keys pressed by the user or by --press-) , removes t;he key^f rom the 
buffer, and sets "zkey" to the value of the key (sets "zkey" to -1 if 
the buffer is empty) 

clrkey (no tag) clears the key buffer 

key type sets a variable according to the position ixx a list of the input by 

the user; if the input action is not listed, the variable is set to -I 

keytype VAR,ARG0,ARG1 ,ARG2 , . . . 

arguments ARG0, ARGl , ARG2,... may be any of the following: 

KEYNAME (any keyname; no quotation marks are used; 

function keys are in lower case) 
KEYLIST NAME (name of a system-defined keylist or of a list set up by 

the -lieylist- command) 
ext ^ (any external Input) 

touch(COARSE, WIDTH IN CHARACTERS, HEIGHT IN LINES) 
touch(FINBX,FINEY, WIDTH IN DOTS, HEIGHT IN DOTS) 

(COARSE or FINEX,FINEY is the screen position of the lower left 
corner of a rectangle with specified width and height; width 
^ and height are optional and are assumed to be 1 if omitted) 

Note: Up to 97 keys may beNjpecif ied; keylists count as one key. 

- i. u u 
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NOTE: The following commands have similar forms to their TUTOR counterparts 
with exceptions as noted: 
-If-, -elself-, -else-, -endif-, -loop-, -reloop-, -outloop-, -endloop-, 
-cstart-, -estop-, -estop*-, -use-, -keyllst-, 

-next-, -ne>:tl-, -back-, -backl-, -help-, -helpl-, -data-, -datal~j 
-lab-, -labl-, -stop-, -Iraaln-, -goto-, -do-, -jump-, -base-, -doto-, 
-pause-, -branch-. 

Argumented units are not available* 

Conditional expressions must conform to restrictions on calculations. 
There is no iterative -do-. 

Tag "q" must be used to inactivate a key with the corresponding command, 
e.g., -back-, -lab-, etc. 

Explicit -next- command is required to proceed to the next unit. 
There is no -end- command; a help-type sequence ends with a unit with 
no -next- command. 

Only the blank-tag form of -base- is available. ' 
With -doto- all index values must be integers. 

With -pause- there is no minimum time; the key is returned in "zkey". 
The -branch- command appears only in the command field. 



1 ('^ 
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Running assembler programs 



All commands In this subsection must be executed In a TUTOR program* 



pptaddr establishes a bas/e address or location In the read/write memory of 
the termlnaj. for subsequent loading, testing, running, and clearing, 
of a program or for loading of data 

pptaddr ADDRESS 

pptaddr ADDRESS FOR LOADIJIG,ADDRESS FOR RELOCATING 

pptaddr (B) (sets buse address to default, which Is "ztbase"+2043) 



pptload loads and relocates. If required, the program In the specified 

binary block at the location specified by the previous -pptaddr-; 
If LESSON NAME Is omitted, the current lesson Is assumed 

pptload LESSON NAME (opt), BLOCK NAME 
pptload <LESSON POSITION> (opt), BLOCK NAME 

pptload (B) (clears all flags Indicating that programs are loaded 
Into the terminal's memory) 



Note: zreturn « -1 

a 0 

» 1 
» 2 
» 3 



If program Is loaded successfully 

If the binary block Is not found 

If the STOP key Is pressed during loading 

If the terminal Is not programiiable 

If the binary has a bad length 

If there are too many programs In aemory 

If there Is an error In the binary format 

If there Is a system disk error 



ppttest sets "zreturn" to test whether the specified binary block Is loaded 
In the terminal's memory at the address specified by a previous 
-pptaddr-; If LESSON NAME Is omitted, the current lesson Is assumed 

ppttest LESSC*" NAME (opt), BLOCK NAME 
ppttest <LESSON POSITION> (opt), BLOCK NAME 



Note: zreturn « -1 



If the binary Is loaded at the previously 
specified address 

if the binairy is not loaded at that address 



pptclr clears the flag indicating that the specified binary block is loaded 
in the terminal ''s memory at the address specified by a previous 
-pptaddr-, or clears flags for all binaries; if LESSON NAME is omitted, 
the current lesson is assumed 



ERLC 



pptclr LESSON NAME (opt), BLOCK NAME 
pptclr <LESSON POSITION> (opt), BLOCK NAME 
pptclr (B) (clears all flags) 
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pptdata loads data from stiident variables or central memory variables Into the 
terminal's memory, starting at the address specified by a previous 
-pptaddr- 

pptdata STARTING VAR,NUM SEGMENTS, SEGMENT SIZE (opt) 

(SEGMENT SIZE, if omitted, is 60;"lf SEGMENT SIZE > 8, 
only the right-most 8 bits are sent) 

Note: zreturn- « -1 if data is sent successfully 

« 0 if the STOP key is pressed during transmission 
« +1 if the terminal is not programmable 

J 

pptout sends data words and control words stored in student variables or 
central memory variables to the terminal; each "package" of data 
consists of a 19-bit word which specifies a terminal function; 
(LDE, or load echo, is not permitted) 

pptout STARTING VAR,NUM VARS (opt) (NUM VARS, if omitted, is 1) 

Note: zreturn = -1 if data is sent successfully 

« 0 if the terminal is not programmable 

Note: For a complete description of the data words and control words, 
see "The PLATO V Terminal" by Jack Stifle* 

pptrun causes execution of the program residing at the address specified by 
a previous -pptaddr-, or specifies the entry to be executed in a 
jump table at the beginning of the program residing at the address 
specified by a previous -pptaddr- and sends an 18-blt data word, if 
requested 

pptrun (B) (executes the program at the previously declared address) 
pptrun JUMP TABLE ENTRY , DATAWORD ('"pt) (executes an Instruction 
in a jump table; DATAWORD, if omitted, is 0) 

Note: zreturn « -1 if -pptrun- is s'uccessful 

» 0 if the terminal is not programmable 
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ppthalt after waiting the specified time interval ^ halts programs which are 

running in the terminal if the programs have been appropriately set up 

ppthalt NUM SECONDS (opt) , dependent (halts lesson-dependent programs; 

if omitted, NUM SECONDS is .25) 
ppthalt NUM SECONDS (opt), all (halts both lesson-dependent programs 

and lesson-independent programs; if omitted, NUM SECONDS 

is .25) 

ppthalt (B) (equivalent to -ppthalt .25, all-) 

Note: zretura ^ -2 if no program is running in the terminal 
* -1 if the program is halted successfully 
« 0 if the terminal is the wrong type 

1 if the status (m*statu8) cannot be read 
= 2 if -ppthalt- is in a finish unit ojr 

if NUM SECONDS i 0 
=» ol00 + n, where n is the contents of m. status 
(=* ol61 for lesson-dependent program) 
(=» ol52 for lesson-independent program) 



* J 
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System variables for terminal resident processing 



zanscnt number of response-nnatching commands encountered at an arrow before 
the response Is matched; « -1 If no tag Is mat'^hed 



zcomm provides a counter fot timing Interrupts; Incremented each time an 
Interrupt Is received 

zdata number of 8-blt bytes of data sent from the central system by -xmit- 

zentlre -1 If a^ required words are present In the response, « 0 otherwise 

zextra « -1 If there are no extra words In the response, = 0 otherwise 

z jcount number of characters entered at a pTUTOR -arrow- 

z judged -1 for any "ok" judgment 

0 for any "wrong" judgment (anticipated "no") 

« 1 for any "no" judgment (unanticipated "no") 

= 2 for a response which is not matched; also set by -judge exdent 

zkey contains the keycode of the last input (updated after -arrow-, 
-pause-, -getkey-, and at the beginning of a main unit) 

zldone =» -1 if the user has encountered -lesson complete- 

= 0 if the user has encountered -less^^n Incomplete- 
= +1 if the user has encountered -lesson no end- 



zmode -1 with -mode erase- 

= 0 with -mode rewrite- 

=» 1 with -mode wrlte- 

=» 2 with -mode Inverse- 



zntrles number of attempts at the current arrow 

zopcnt number of arithmetic operations in a numerical response (set with 
-ansv-, -wrongv-, -compute-) 

zorder « -1 if the vord order is correct, « 0 otherwise 
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zrecs 



Liumber of records in the attached dataset 



zreturn set by some commands according to the results of execution; set by: 

-attach-, -charset-, -compute-, -datain-, -dataout-, -file-, -loadu-, 
-pjntd-, -runu-, -textn-, -trap-, -xmit-, -pptdata-, -ppthalt-, 
-pptload-, -pptout-, -pptrun-, -ppttest- 

zrouten indicates entry conditions to the router lasson; 

= 0 if this is the first entry to the router lesson 

1 if this entry to the router Is via -jumpout- 
= 2 if the router is returned to when the end of the instructional 

lesson is reached 
a 3 if the router is returned to v^hen the instructional lesson is 

terminated by STOPl keypress 
=•4 if the router is returned to when an execution error occurs 
in the instructional lesson 



zsc 



ote rounded value of the tag of pTUTOR -score- (value from 0 to 100) 



zspell » -1 if spelling is correct, = 0 otherwise 

ztbase (TUTOR only) address of the first available read/write memory byte in 
the user's terminal 

ztmem (TUTOR only) number of 8-bit bytes of memory in the user's terminal 

ztmemr (TUTOR only) number of available 8-bit bytes in the terminal's memory 
after a -loadu- command 

ztprog (TUTOR only) « -2 if the user's terminal is programmable and /iTUTOR 
may be available 
« -1 if the user's terminal is programmable but fiTUTOR is not 
available 

» 0 if the user's /terminal is not programmable 

ztrap number of bytes of output pendin^> from the central system; each 
terminal word is 3 bytes, so "ztrap" is a multiple of 3 
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\ 



/ 

zttype gives information on the user s terminal; counting from the left end 
of thv 8-bit word: 
1 bit: always 0 

3 bits: memory configuration (see "aids" for details) 

4 bits: terminal type 
if the terminal is a PLATO IV 
3, 4 if the terminal is an ISTl 

b if the terminal is an IST2 
6 if the terminal is a current PPT 
8, 9, 10 if the terminal is a PPT 

12 if the terminal is an ASCII terminal 

13 If the terminal is a TV terminal 

14 if the terminal is an ISTl 

15 if the terminal is an IST2 



0 



Note: The TUTOR version of "zttype" gives terminal type only; value 
are the same except for 6, which is unused, and 14, which is 
used for current PPT. 



zv/couht number of words in the response (maximum of 50); set by -answer-, 
-wrong- , -an s were- , -wr ongc- 



zwherex fine-grii^x location for the next display in pTUTOR processing 



zwherey fine-grid y locition for the next display in pTUTOR processing 



1 

1 i 
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Limits associated with commands (for TUTOR version unless specified otherwise) 
area 



args 

argumented unit 
arheada 



box 
gbox 
rbox 

bump 

calcc 
calcs 

charlim 

common 

comload 

compute 

conditional form 
of commands which 
reference unit 
names y c^g^t -next-, 
-help-, etc. 

cpulim 

define 



10 characters in name of area 
10 arguments 
five 6-bit characters 

95 dots thick 



8 characters 

61 calculations 

value of tag from 0 to 127 

8000 variables (>1500 variables requires -comload-) 
1500 variables 

100 characters in character string (TUTOR) 
127 characters in character string (pTUTOR) 

100 unit names (line containing 101st name is flagged 
as a condense error) 
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delay 
deletes 

do \ 
join/ 

drav 

gdraw 

rdraw 

edit 



combined 



value of tag from 1 to 10 

7 characters in name of define set 
7 characters in name of variable 

1500 definitions (fewer if definitioas are complicated) 

500 definitions in define set "student" 

6 arguments in defined function 

10 units (e*g*, kg, m, sec, liter, itc.) 

255 elements in an array 

5 active define sets 

1 second maximum 

value of Increment from 1 to 500 
10 levels 



63 arguments 

17: 

maximum of 300 characters in buffer , 
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endings 

finds 
f Indsa 

graph 

group ' 

hbar 
vbar 

inserts 

keylist 

keytype 

labelx 
label y 
markx 
marky 

list 

loada 

loadu 

long 

Ivars 

move 

name 

noword* 
okword 

outputl 

pack 

packc 

pause 

press 

put 

putd 

putv 



WW 



10 separate -endings- commands, 8 endings in each tag 
value of increment from 1 to 500 

characters in string to be plotted 

8 characters in sign-on group name 

9 characters in string to be plotted 

(increment between entries)x (number of entries to add) ^ 500 

from 2 to 7 characters in the name 

100 keys in tag (keylists count as one key) (TUTOR) 
97 keys in tag (keylists count as one key) (^TUTOR) 

100 marks maximum plotted on an axis 

7 characters in name of list 
300 characters 
20 units 

300 characters (>150 requires -edit- for active EDIT key) 

128 local variables 

5000 characters may be moved 

18 characters in sign-on name 

9 characters in word 

10 characters in label, 20 consecutive variables 
500 characters in character string (with embeds) 
100 character strings 

.75 second minimum 
1 keypress per second 

50 characters in strings; expansion due to string 
replacement limited to 300 characters 
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randu 

return 
routvar 
score 
set 

setdat 
setperm 



Integer from 0 to 2^6 (TUTOR) 
Integer from 0 to (2l* - 1) (jiTUTOR) 

10 arguments 

64 variables 

value of tag from 0 to ^ (TUTOR and fiTUTOR) 

up to 61 separate values (TUTOR) 
up to 95 separate values (pTUTOR) 

value for "atlme" less than elapsed time for the session 
values for "aarrows", "ahelp", etc. less than 512 

(one-argument) integer from 0 to 1^(5 
(two-argument) integer from 0 to 3000 



sort 
sorta 

storage 

term 
tp' op 

time 

timel 

timer 

transf r 



unit 

unitop 

entry 

vocab 
vocabs 



value of increment from 1 to 200 
8000 variables 

8 characters in string, 299 terras in a lesson 

#75 second minimum 
•75 second minimum 
60 seconds minimum 
length is the smaller of: 

size of common or storage (reference to EM) or 
length of -comload- or -stoload- (reference to CM) oir 
150 (reference to student variables) or 
tag of -routvar- (reference to router variables) 

8 characters in name 

500 condensed words in a unit 

394 distinct condensed units in a lesson 

7 characters in name of vocabulary 



*list commands 



10 commands 




7g 
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Standard PLATO Keyset 



MICRO • plots period followed by 7 spaces 

MICRO Q writes to left from current position 

MICRO R writes to right from current position 

MICRO CR writes to left in alternate font from 

right edge of screen 

MICRO T writes in boldface font (on ppt) 

MICRO S writes in standar/i font (on ppt) 

MICRO ^ toggles locked shifted letters 



Upper Access, 
Cose Upper 
Cose 



Lower 

Cose 



Access, 
Lower 
Cote 



< < 
0 < 



> > 
1 > 



$ ♦ 

4 



% 

5 (a 



6 S> 



8 



) 



SUPER 



SUB 



TERM 
ANS 



COPY 



CR 
TAB 



+ a 



Q 

q ^ 



W f 



E 

e / 



R 



T 

t 9 



0 a 



P 

P *• 



ERASE 



FONT 
M!CRO 



HELP 



□ 



a a 



s 

8 <r, 



D 

d S 



F ♦ 



G 

g 



H 
h 



K 
k 



L 

I X 



NEXT 



EDIT 



BACK 



LAB 



n 



u X 

X o 



SHIFT 



Z 
z 



C©1 
c 



V 

V 



B 

b $ 



N 

n 



m /* 



p 

/ \ 



SHIFT 



DATA 



STOP 



177 



BACKSPACE 
SPACE 



HALF- BACKSPACE 
HALFSPACE 
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KEYCODES' 



key 


keycode 


key 


keycode 


key 


keycod<t: 


d 


1 




1 




A.C mm 






y / 


« 0 1 T I 


D 






>^Clf '7 


• 


^7 « 


oi> / 




Q Q 

y 0 


» 0 1 


C 






Ox> 0 




>1 Q _ 

no «« 








« 01 


d 








r 

[ 




OD 1 


A 


1 Of 7 


= 0 1 TO 


€ 






OUi> 


J 






/ 


\ (X A. 


= 0 1 t> 


I 


J? 




OWD 




CI M 


obo 




1 1 or 


« 0 1 i> b 




7 




/ 


X 


c; ? a 

^ c ^ 




1 


1 1 1 
ill 




n 


0 
0 




1 Q{ 
\J I Kf 




^ s 


rift ^ 




1 1 7 


a 0 1 ft l**^ 


1 


9 






sub 


^ I ** 


Ob D 




\ 1 ft 


= 0 1 6 4 


J 








supep 




06 7 


i OCK^UO 


i L V 


a 0 1 ft ft 


K 


1 1 
1 1 






5n I IT. <? 






I OCKSUp 


11? 


= 0 1 67 


t 
I 


1 2 




0 1 4 


Ccip pet 


^7 a 


o7 1 




1 2 7 


= 0 1 7 7 


m 








\ 


JO ** 


\J * £. 


n IMUTY 




= o200 




1 4 






s 




o7 3 




1 ^ Jv 


s o202 


o 


1 




n 1 7 


Qrv^^polCe 






INL.A 1 1 


1^1 


a o2 0 3 


P 


1 A 

i V 






I oriT. 


ft 1 a 


\J / ^ 


rPAQr 

iLrsnOL. 


1 32 


- o2D4 




1 7 






access 


ft? a 


o76 


tirf not- 1 


1 3 3 


s <;>2 0 5 




1 

1 Q 








ft 1 a 


oil 


wri P 
nt-L-p 


1 34 


s o2 06 




1 ^ 




o2 3 


Ck 

n 


65 " 


ol 0 1 


MFI Pi 


1 35 


= o20 7 


t 


^ *j 




(^'^ 4 


D 


66 » 


0 102 




1 36 


= o210 


u 










ft 7 a 


ol 03 




1 3 7 


= o2 1 I 








4. 'J 


n 


68 ^ 


ol 04 


1 AR 


1 365 


= o2 1 2 


I't 








L. 


ft Q a 


ol 05 


1 ARl 


1 39 


= o2 1 3 




2 4 




o30 


r 


70 = 


ol06 


HATA 


1 40 


a o2 1 4 


V 






o3 1 




7 1 = 


ol07 


L'n 1 n i 


i 4 1 


= -wO 1 5 








o32 


u 
n 


72 e 


ol 10 


TFPM 


1 42 


a o2 1 b 




2 / 




o33 


T 
1. 


73 a 


ol i 1 




1 43 




1 


28 




o3 4 


T 

'J 


74 s 


ol 1 2 




1 44 


= o2 20 




29 




o35 






ol 1 3 




1 45 


= C-2 2 1 




30 




o36 


1 


76 = 


ol I 4 




1 46 


= 0222 




3 1 




o37 


M 
1 1 


77 - 


ol 1 5 




1 47 


= o2 2 3 




32 


s 


.o40 




78 « 


ol 16 


MICRO 


148 


=T o224 


D 


33 




o41 


0 


79 « 


ol 17 


cnUAPF 


1 49 


= c225 


7 


34 




c-42 


p 


80 « 


OI20 


STOP 


1 50 


= ■:'226 


8 


3? 




o43 


0 


81 


0I2I 


STOPl 


151 


= o227 


9 


36 




o44 


R 


82 « 


0I22 


TRB 


152 


» o230 




37 




o45 


S 


83 « 


0123 


TIMEUP 


155 


a o2 53 




38 


X 


o46 


T 


84 = 


o\?'4 


CRTCHUP 


157 


^ o235 




39 




o47 


U 


85 « 


ol25 


touch- 


256 


= o400 


/ 


40 


a 


o50 


V 


86 - 


ol26 


panel 


i 


1 


( 


41 


s 


o51 


w 


87 = 


ol27 


inputs 


511 


a 0777 


) 


42 


re 


o52 


X 


88 = 


ol30 


extepnal 


512 


= OI000 


$ 


43 




o53 


Y 


89, » 


ol31 


inputs^ 


i 


1 


if 


44 


K 


o54 


Z 


90 « 


0132 




767 


» 0I377 


space 


45 


X 


o55 















"key" contains the keycode of the last key pressed. 
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INTERNAL CODES 



unshi fted 


3hi fted 


access 


access 


-shi fted 


char 


code 


char 


code 


char code 


chsr 


code 


a 


001 


R 


O7001 


fv o7601 




O767001 


b 


O02 


B 


O7002 


ft o7602 






c 


oD3 


C 


o7(3f03 


^ o7 603 


(c) 


o 7 6 7 n ri 


d 


ou 4 > 


D 


O70O4 


$ o7604 




O7670O 4 




O05 


E 


O7005 


o7605 






f 


o06 


F 


O7006 






O767006 




O07 


G 


O7007 










ol0 


H 


O7010 








« 
* 


ol 1 


I 


o70 1 1 


• 


1 


o7*^70 1 1 


} 


cl2 


J 


O7012 








); 


ol3 


K 


07013 








I 


oM 


L 


O7014 


X o76l4 








ol5 


f1 


O7015 


ji o7 615 






n 


ol6 


N 


O7016 


o7616 






o 


ol7 


0 


O7017 


o; S 1 7 


o 


O76701 7 


F- 


oC0 


P 


O7020 


If o7620 








o:i 


Q 


O7021 


o7 621 






r 


o22 


R 


O7022 


p 07622 






s 


o2 3 


S 


O7023 


cr o7623 






t 


'::4 


T 


O7024 


9 07624 






u 


o2? 


U 


O7025 


07625 






V 


026 


V 


O7026 


07626 








c2 / 


I'J 


O7027 


W 07627 


t 


O767027 




o50 


K 


O7030 


O7630 




O767030 


y 


o31 


Y 


O7031 








z 


o32 


Z 


O7032 










o33 


left64* 


o7033 


< o7633 






1 


o3 4 


left* 


O7034 


> o7634 








o35 




O7035 








3 


o36 




O7036 


- 






4 


o37 




o7037 








5 


o40 


right ^ 


O7040 


(3> O7640 






6 


c41 




O7041 


^ 07641 






7 


o42 




O7042 








8 


o43 


bold* 


O7043 








9 


o44 


Linbo Id* 


o V 0 4 -4 








+ 


o45 


I 


O7045 


^ 07645 








o46 


A 


O7046 








* 


o47 












/ 


O50 


9 


O7050 


N O7650 






( 


o51 


lokcap* 










) 


o52 






s 07652 






' $ 


o53 






# 07653 






s 


o54 






07654 






space 


o55 






, 5space o7655 






f 


o56 


N 


O7056 


* 07656 








o57 


! 


O7057 










o60 




O7060 









INTERNf^ COOES (cont.) 



unsh 1 ft 


ed 


shi 


fted 


access 


access- 


•shi fted 


char code 


char 


code 


char 


code 


char 


code 


[ 


o6l 






{ 


o7 66 1 






1 


o62 






\ 
/ 










o63 


















u 


O7064 


c 


o7664 


X 


0767064 




o6? 






cr 01^ 


o7665 








o66 


loksub* 


O7066 ' 


dnl in* 


o7666 


Idnlin* 


O767066 


super ^ 


o67 


1 olcsup 


o7067 


upl in"" 


o7 667 


1 up 1 1 n* 


o7 67J067 


5hi ft'' 


o70f 














c-ar ret'^ 


o7l 


Idnlin^ 


O7071 


crl0l* 


o767l 






< 


o72 






< 


o7672 






> 


o73 






> 


07673 






bk space 


o74 






• Sbksp 


o7674 






font 


o75 






acfont* 


07675 






\ access 


o76 














t 


o"7 




O7077 




07677 


>- 



































left64 
left 
e 

m , r 

r iiht 
bold 
unb'i' Id 
l':.)':ap 



cr 01 
sub 

ioksub 
dnl in 
Idnl in 
super 
1 ohsup 
uf:- 1 1 n 
lupl in 
shi ft 
car ret 
cr 101 
ac f ont 



write to left, starting at character position 64 
hir;te to left, ijlarting at viurrent position 
display in (node erase 
display in mode lurite 
d 1 sp 1 ay in mode rewr i te 

j^rite to ri^ht, starting at current position 

I'lrite in bold characters (ppt only) 

firite in standard cltaracters (ppt only) 

to-igle locked shifted letters--act i vated by a micro 

I'fhich IS defined as SHIFT ( 

[code 07J951 does not appear in character string] 

ite on nevt line, starting at character position 1 
write next character doion 5 dots 
write all subse^^uent characters doujn 5 dots 
writ^ next character down one 1 ine (doo^n 16 dotsi 
write all subsequent characters down one line 
write nevt character Up 5 dots 
write all subsequent characters up 5 dots 
write next character up one line (up 16 dots) 
write all subsequent characters up one line 
shift code--isol3ted shift code obtained by SHIFT 
write on next line, starting at left margin 
start writing at screen position 101 
font code which is not erased when the character 
following it -IS erased 



The following characters, although produced with the shift 
key, do not produce a shift code in the internal code: ^ ■ 
♦ ,'(,),$, t, ] , <, >, car ret, bacl'^oace, font, access, 
These characters are listed in the "un^hi fted" category. 



18 1 



A8 



ALTERNATr FONT TERMINAL MEMORY LOCATIONS 
(key associated with terminal memory location) 



oc 


key 


loc 


key 


loc 


key 


loc 


key 


loc 


key 


8 


space 


27 


0 


54 


(k) 


81 


Q 


103 


) 


1 


a 


28 


1 


' 55 


(1) 


82 


R 


109. 


(E) 


2 


b 


29 


2 


56 


(m) 


83 


S 


1 10 


(F) 


3 


c 


30 


3 


57 


(n) 


84 


T 


1 1 1 


(Q 


4 


d 


■ 3! 


4 


58 


(o) 


85 


U 


112 


n 


5 




32 


5 


59 


J 


86 


V 


1 13 


(H) 


6 


f 


33 


6 


60 


\ " 


87 - 


Ul 


1 14 


(I) 


7 


g 


34 


7 


61 




88 


X 


1 15 


(Jj 


8 


h 


35 


8 


62 


. 


89 


Y 


1 16 




' 9 


i 


36 


9 


63 


unav 


90 


Z 


1 17 


(/) 


ija 


j 


37 


+ 


64 


space 


91 


< 


1 18 


(K) 


1 1 


k 


38 


- 


65 


A 


92 


> 


119 


(L) 


12 


1 


39 


(a1 


66 


B 


93 


[ 


120 


(M) 


1 3 


m 


40 


/ 


67 


C 


94 


] 


121 


(N) 


14 


n 


41 


(b) 


68 


D 


95 


$ 


1 22 


(0) 


15 


o 


42 


(c) 


69 


E 


96 ' 


% 


t 23 


« 


16 


P 


43 


(d) 


70 


F 


97 




124 


! 


17 


q 


44 




71 


G 


98 


1 


125 


(!) 


13 


r 


45 


^e) 


72 


H 


99 


« 


126 


(.) 


19 




46 


(0 


73 


I 


10ef 


( 


127 


unav 


2& 


t 


47 


Cg) 


74 


J 


101 


I 






21 


Ll 


43 




75 


K" 


102 


A 








'•/' 


49 


(h) 


76 


L 


103 


(A) 






23 


W 


50 


(i) 


77 


M 


104 


9 






24 


x 


51 


(j) 


78 


N ~ 


105 


(B) 






25 


y 


52 


X 


79 


0 


106 


(C) 






26 


z 


53 


4= 


80 


P 


107 


(D) 







^|NQTE: unav: Location is unavailable for storing character 
^ (key) ; Press MICRO and then the indicated key or 

Press SHIFT-SQUARE and then the indicated }-.ey 



\ 



KEYCODES* 
(programmable terminal) 



key keycode 



t i meup N - 1 



0 




1 


1 


2 


2 


3 


3 


4 


4 


5 


5 


6 


6 


' 7 


7 


.8 


' 8 


9 


9 




10 


- 


11 


t-ab 


12 


assign 


13 


+ 


14 




15 


sup 


16 




1 7 




1£5 


erase 


19 


micro 


20 


help 


21 


ne ^t 


22 


edit 


23 


beck 


24 


data 


25 


stop 


"26 


ccpy 


27 


square 


28 


lab 


29 



key keycode 



< 


32 


> 


33 


[ 


34 


] 


35' 


$ 


36 


% 


37 




38 


7 


39 


* 


4J3 


/ ( 


41 




42 




43 


, cr - 


-^4~ 


ass I gn 1 


45 


> 

A. 


46 




47 


supl 


48 


subl 


49 


term 


50' 


erase 1 


51 


font 


52 


helpl 


53 


next 1 


54 


editl 


55 


backl 


56 


datal 


57 


stopl 


58 


copyl 


59 


square I 


60 


lobl 


• 6,1 



key keycode 



space 


64 


a 


65 


b 


66 


c 


67 


d 


68 


e 


69 


f 


70 


g 


71 


h 


72 


1 


73 


j 


74 


k 


75 


^1 


76 


m 


77 


n 


78 


0 


79 


P - 


80 


q 


81 


r 


82 


s 


83 


t 


84 


u 


85 


V 


86 


w 


87 


X 


88 


y 


89 




90 




91 


f 


92 


/ 


:3 




94 


f 


95 



key keycode 



bksp 


96 


R 


97 


B 


98 


c 


99 


D 


100 


E 


101 




102 


G 


103 


H 


104 


I 


105 


J 


106 


K 


107 


L — 


- 1-0*5- 


M 


109 


N 


1 10 


0 


1 1 1 


P 


112 


Q 


113 


R 


1 1 4 


S 


1 15 


7 


116 


U 


117 


V 


118 






X 




Y 


121 


Z 


122 


) 


123 




124 


? 


125 


1 


126 




127 



System variable "zkey" contains the keycode of the last 
input. 

Turiction "zk" retur^is keyset keycode values. 
Touch-panel input codes range from 256 to 511. 
E:xternal input codes t ange ft^om 51 2 to 767. 




A10 



Powers of 2 



n 




2^ 




n 




2" 






1 


— 8 






1 073 741 824 


1 




2 




O 1 




2 1a7 483 648 


2 




4 




32 




4 294 967 296 






8 


=8^ 


33 




8 589 934 592 


4 




16 




34 




17 179,869 184 


5 




3 2 








'54 359 738 368 


6 




64 


— O 


OD 




OO #1^ 'x#0 


7 




128 




37 




137 438 953 472 


8 




256 




38 




274 877 906 944 


9 




512 


=8 


39 




549 755 813 888 


4 ft 




1 )fl^4 




A(A 


1 
1 


CfQQ 511 627 776 


1 1 




2 j04o 




A^ 
*± 1 




1 QQ 023 255 552 


1 2 




4 jSf96 


=8^ 


42 


4 


'^98 046 511 104 


13 




8 192 




43 


8 


796 093 022 208 


14 




16 384 




44 


17 


592 186 044 416 


15 




32 768 




A R 




1 04 "^79 R*?? 


16 




6d bob 




'tD 




268 744 177 664 


1 / 




131 jJ72 




47 


140 


737 488 355 328 


18 




262 144 


=8^ 


48 


281 


474 976 710 656 


19 




524 288 




49 


562 


949 953 421 312 


29 


1 


iJ48 576 




50 


1 125 


899 906 842 624 


21 


2 


097 152 


=8^ 


5l' 


2 251 


799 813 685 248 


22 


4 


194 304 




52 


4 5JJ3 


599 627 370 496 


23 


8 


388 6). 3 




53 


9 007 


T99 254 740 992 


24 


16 


777 216 


=8« 


54 


18 014 


398 509 481 984 


25 


33 


554 432 




55 


36 028 


797 018 963 968 


26 


67 


1j98 864 




56 


72 057 


594 037 927 936 


27 


134 


2->7 728 


=8^ 


57 


144 115 


188 075 855 872 


28 * 


268 


435 456 




58 


288 230 


376 151 711 744 


29 


536 87JS 912 




59 


576 460 


752 303 423 488 



=8 



10 



=8 



11 



=8 



.12 



=8 



13 



=8 



14 



=8 



15 



=8 



16 



=8 



17 



=8 



18 



=8 



19 



Given the byte size = n: range for unsigned integers is 0 to 2 -1 

range for signed integers is -(2'^ ^-1) to +(2^ -1) 

Given the maximum absolute value such that 2^ ^ < |ma:<imumj < 2^: 

byte sizv for unsigned integers is n 
byte size for- signed integers is n+1 • 



ERIC 



o 0 



INDEX 



Alphabetical index to system variables 

System variables may be used wherever expressions are accepted, e^g*^ in tag C 
of -calc-, -at-, etc* 



Word 


Page 


Word 


Page 


Word 


Page 


Word 


Page 


aarea 


D6 


ntrles 


J19- 


zfacc 


F19 


zscore 


T29 


a arrows 


D6 


opcnt 


JZd 


zflle 


F19 


zsessda 


D5 


ahelp 


D6 


order 


J2i) 


zfroml 


S22 


zsesset 


D6 


ahelpn 


D6 


phrase 


J20 


zfromu 


S22 


zsesspt 


D6 


anscnt 


J19 


proctlm 


S22 


zf type 


F19 


zsnflle 


S23 


ansok 


J19 


ptlme 


S22 


zf users 


F19 


zsnotes 


S23 


aok 


D6 


rcallow 


R3 


zgroup 


S22 


zspell 


T29 


aolcist 


D6 


router 


R3 


zld 


S23 


zsvars 


F20 


args 


S21 


rstartl 


R3 


zlnfo 


F19 


zsvret 


F20 


asno 


D6 


rstartu 


R3 


zj count 


T28 


zsysld 


S23 


aterm 


D6 


rvallow 


R3 


zjudged 


T28 


zsystem 


S23 


atermn 


D6 


sitenam 


S22 


zkey 


T28 


ztbase 


T29 


a time 


, D7 


size 


P21 


zlang 


P21 


ztera 


S23 


auno 


D7 


slzex 


P21 


zld one 


T28 


ztmem 


T29 


backout 


S21 


sizey 


P21 


zleserr 


RA 


z tmemr 


T29 


baseu 


S21 


•3 pell 


J20 


ziesson 


S23 


ztouchx 


S24 


capital 


J19 


station 


S22 


zlsac 


M6 


z touchy 


S24 


clock 


S21 


tactlve 


S22 


zllne 


F19 


ztprog 


T29 


dataon 


D6 


user 


S22 


zmode 


T28 


zttap 


T29 


entire 


J19 


usersin 


S22 


znlndex 


F19 


zttype. 


T30 


errtype 


R3 


varcnt 


J2|5 


znscpn 


F19 


ztzone 


S24 


extra 


J20 


vocab 


J20 


" znsmaxn 


F19 


zunlt 


S24 


f ormok 


J21 


wcount 


J2t) 


znsmaxr 


F19 


zusers 


S24 


f romnum 


S21 


where 


P21 


znsna>ns 


F19 


zwcount 


T30 


j count 


J19 


wherex 


P21 


znsrecs 


F20 


zwherex 


T30 


judged 


J19 


wherey 


P21 


zntrle« 


T28 


z wherry 


T30 


key 


S21 


zaccnam 


S22 


zopcnt 


T28 


zwpb 


F20 


1 common 


C23 


zanscnt 


T28 


zorder 


T28 


zwpr 


li"20 


Idone 


R3 


zbatch 


S22 


zpnflle 


S23 


zxflle 


F20 


lessnum 


S21 


zbpc 


C23 


zpnote^ 


S23 






IJ.eslst 


S21 


zbpw 


C23 


zrecs 


F20,T29 






llesson 


S21 


zcheck 


F19 


zretrnu 


S23 






Iscore 


R3 


zcorom 


T28 


zreturn 


S23,T29 






Istatus 


R3 


zcondok 


S22 


zrof f 


F20 






Istoiag 


C23 


zcpw 


C23 


zrouten 


T29 






eialnu 


S21 


zcurrlc 


R3 


zrunner 


M6 






mallot 


321 


zcusers 


C23 


zrstatn 


F20 






mode 


P21 


zdata 


T28 


zrtype 


F20 






mui,<: 


S21 


zentlre 


T28 


zrvars 


F20 






nhelpop 


S22 


zextra 


T28 


zrvret 


F20 







D 



M 



R 



S 



A, 
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Alphabetical index to commands and 



L>ommana 


D O f> A 

rage 


Command 


Page 


a DOl L 




cnedcpc 


T?l A 

r m 


o o a G 




circle 


d7 T 1 q 
r/ , 1 ly 


acicixs L 




clrcieb 


d7 T 1 Q 

r/ J 1 ly 


aQQ 1 




clean 


PI A 


addname 




clock 


cip 


O <4 T*00 C 

clUClL CCb 


ro 


close 


TC 

Jj 


allow 




c 1 rke y 


TO 9 


oil /%r t 
aXi.Ow 


Tl ft 
1 1 o 


collect 


CQ 

by 


axe rone 




comload 


P9rt 


one 
alio 




common 


P9£A 


ansu 


T 1 9 


comrjonx 


P9 1 


ansv 


Til Tl 9 
J 1 1 ) 1 1 ^ 


compare 


Tl A 

J 14 


answer 


TQ Til 


comret 


P9rt 


answera 


Tl flS 


compute 


Clf9> 14 


answerc 


T 1 Til 


concept 


J10 - 


array 


PI 


copy 


tO ti /A 

J:>, 1 li£; 


area 


n9 


cpulim 


C 1 1 

Sll 


args 


CIO 

SI J 


cstart 


814 ,T24 


argument 


CI c O 

bi , SZ 


estop 


S14,T24 


arneaoa 


t9 
J 


estop* 


CIA TO A 

bl4 ) rZ4 


arrow 


TO TO 

, ly 


ctirae 


Cll 


arrowa 


T9 


darrow 


TO 

ly 


at 


T5 1 T 1 Q 

r 1 , 11 y 


data 


8/ ,T24 


atnm 


Pi ,T19 


datal 


C 7 O A 

87 ,T24 


attach 


1? 1 tQ 

r 1 , To 


datain — 


FJjTo 


audio 


D 1 A 

r lo 


aataoit 


ni 
Ul 


axes 


Dirt T 1 Q 

r ijy , 1 i y 


dataon 


Dl 


back. 


C 7 T 9 /. 
D/ ) IZ^ 


dataop 


c o 

88 


bacKi 


C 7 T 9 /. 
b / ) l^H 


datalop 


CQ 

bo 


backgnd 


P99 


dataout 


r J , lo 


backop 


C7 

b/ 


date 


PI 


backlop 


C7 
b/ 


day 


CI 1 


base 


CQ T9 A 

bo > i H 


define 


O 1 'P 0 

Li , IJ 


beep 


Dl 7 ''( i Q 

r 1 / , 1 ly 


delay 


DA 

r4 


block 


PI Q T^ 


deletes 


PI 7 
LI / 


bounds 




del name 


ro 


box 


dA ti q 
rO J i i y 


delrecs 


ro 


branch 


S4 ) l^H 


delta 


P15 


break 


CI 1 

b 1 1 


detdcn 


T? 1 

r 1 


bump 


J J 


disable 


T5 1 /I Tl Q 

Flo , Tiy 


c 


C T 7 

SI / 


do 


CO TO A 

bZ,T24 


calc 


CJ ,TJ 


dot 


TiiC T 1 O 

FOjTiy 


calcc 




d 0 to 


c A t9 A 


calcs 


C3,13 


draw 


Pb,T19 


catchup 


Sll 


edit 


J2 


cdate 


Cll 


else 


S5,T24 


change 


S17 


elseif 


S3,T24 


char 


P5,T18 


embed 


P1,T15 


charlim 


T17 


enable 


P16,T19 


char set 


P19,T17 


end 


S8 


chartst 


P20 


endarrow 


J3,T9 



related directives 



LiomtnanQ 


Page 


Command 


Page 


enai i. 


C ^ T 9 A 


niaaen 




enamgs 


TA 
J4 


hto a 


.PI 9 


endloop 


O ^ T O A 

bo,T24 


i arrow 


T 1 A T 1 9 
J 1 0 y 1 1 ^ 


entry 


C 1 

81 


1 arrowa 


T 1 

J Id 


erase 


P3,Tlo 


ieu 


C 1 

b 1 


eraseu 


T 1 
J 1 


i f 


c «; T^ A 


exact 


Til Til 

J 1 1 , TJj 1 


1 Terror 


C9 


exactc 


Til 
J 1 1 


1 imaccn 


Tl 9 


exactv 


Jll 


igno Lc 


Tl ^ 


exactw 


Til 


1 Judge 


Tl 9 
11 J 


exit 


83 


imain 


C 9 t9 a 

b J f 


ext 


bi 7 
PI 7 


III 


CIA 
b 1 4 


extout 


^P17 


mni Dl L 


Tl ft 
r J ,110 


file 


rpO 

To 


ini Liai 


P9 1 
L*^ 1 


fill 


P6,T1 9 


1 nser ls 


P 1 7 


find 


C18,T5 


intrupt 


Tl Q 

11 y 


rlndaii 


P 1 Q 

Clo 


ios pecs 


T?l A 

r 1 0 


tlnd 


C 1 

blo 


1 coa 


PI 9 
Lil J 


t inds ^- 


Cio 


jkey 


T 9 TQ 


1 1 nd s a 


Ci.0 


jom 


T 1 A C 9 
J 1 0 , b J 


finish 


D5 


judge 


T 1 7 T 1 9 
J 1 / , 1 1 J 


f o-ce 


T 1 T fl 

J 1 ,Ty 


jump 


CO TO A 

bZ , XZ4 


r 0 reg na 


P99 


jumpn 


t9 9 


f rom 


CIO 

bl J 


jumpout 


C 1 9 t9 9 


f unct 


D 1 «i 


Keyi 1 s L 


CO t9 a 

by f i/m 


gat 


D 1 9 T 1 Q 

r 1^ ) 1 1 y 


Key cype 


c 1 tfi t9 9 


gatnm 


1 o Tin 

P12 ,Tly 


K.ey wora 


Tl 1 
ill 


gbox 


1 O X 1 O 

PI J, 119 


1 ak 

lab 


C 7 T 0 A 

b / , 1Z4 


gcircle 


1 o Tin 
PI J , T19 


1 qK 1 

lao 1 


C 7 T9 a 


gdot 


1 O T 1 O 

piz , iiy 


laoeix 


D 1 1 T 1 Q 

r 1 1 , 1 1 y 


gdraw 


Pl 9 Tl Q 


1 o r\ o 1 17 

i aocxy 


D 1 1 Tl Q 

r X 1 , 1 1 y 


getchar 


Tl Q 

llo 


labop 


eft 
bo 


getcode 


C 1 


X ao 1 op 


eft 

bo 


getkey 


T23 


lang 


dA 
r4 


getline 


T?l "7 

r 1 / 


lesiis L 


CI *\ 

b 1 J 


g e ci 0 c 


T 1 A T 1 A 
J 14 y 1 14 


XCoo J. 11 


CI '\ 


getmark 


T 1 9 T 1 A 
J 1 J ) 1 14 


1 ^\ ^ A ^ n 

lesoon 


n 0 t9 9 


getndine 


r 3, r 1 J 


^ ^ n A c A ^ 

uLinese L 




getword 


T 1 9 

J 1 J 


I -I at- 

II sc 


TA 


r» ^-1 1 1 

gtlii 


Tl 7 

11 / 


iname 


CI A 
o 1 0 


gorigin 


Tj 1 M Tl Q 

r Ip > i ly 


load a 


T'^ 


goto 


C9 T9 A 


1 oad u 


Tl 




PI 


1 nno 




group 


cii) 


loop 


S6,T24 


g vector 


P14,T19 


1 seal ex 


Pll 


haltu 


T2 


Iscaley 


Pll 


hbar 


P14,T19 


1 /ars 


C3 


help 


S7,T24 


markup 


J18 


helpl 


•j7,T24 


markupy 


J18 


helpop 


S8 


markx 


P11,T19 


helplop 


S8 


marky 


P11,T19 



\ 

\ 



13 



Alphabetical Index to commands and related directives (cont«) 



\ 

V 



ERIC 



Comifiand 


Page 


Command 


Page 


Command 


Page 


match 




L U L CiW 


Pfi T1 Q 


so^ta 


PI ^ 


micro 


131 Q 






specs 


TA Tl (fk 

JO y XX|9 


mi scon 




reauoc u 


UJ 


station 




mode 








status 


R2 


mod perm 


PQ 


VPP n Amp 




step 


»C1 7 

»bX / 


move 


CI 3 


LcCU LCI 


PI A Tl Q 


stoload 


PO 0 


name 




recozras 


ro 


stop 


c»7 nnO A 

S / , T2 H 


names 


F/ ,F10 




vx.^ 5 r H ]^ ox Q 


sto rage 


PO 1' 


next 


S/ ,T24 


rexoop 


00 y XZ4 


store 


TQ 

Jo 


next 1 




remove 




storea 


JO 


nextnow 


o/ 




CI S 


sto r en 


TQ 

Jo 


next op 


S7 


L CllcUUC 


r J 


storeu 


TQ 

Jo 


next lop 


S7 


reserve 


PO 0 T7Q C 1 £ 


subX 


r» A 

C4 


no 


TIC m 1 O 

J15 ,T12 


V* A A ^ n W> 4* 

res uar L 




tab set 


Ply ,Tio 


notes 




iresuore 




term 


Cft 


novord 


Jlo,Tl J 


re u urn 




tennop 


CO 

bo 


ok 


TIC nnl O 

Ji5 ,T1 I 




nO Tl Q 
t 0 ) i. I 7 


text 


"DQ Tl 7 

r J , X X / 


okword 


J18,T13 


rotate 




ceTicn 


Tl 7 
XX / 


open 


J8 


route 


KX 


time 


c 1 

SX (9 


or 


J..2,T12 


rouuvar 


P 1 


uimei 


CI 

oX |lI 


otoa 


C13 


runu 


T9 
x^ 


timer 


DXJli 


out loop 


S6,T24 


rvec tor 


PQ 


touch 


Tl 0 

J xz 


output 


D2 


say 


PI ft 


touchv/ 


T 1 0 

J xz 


outputl 


D2 


8 aye 


PI ft 


transf r 


P 1 Q 


pack 


C12,T5 


oajrX clllg 


PI ft 


trap 


TO 1 
iZX 


packc 


Ci J 


scalex 


P10,T19 


unit 


0 1 Tl 
bX yXX 


parse 


F18 


scaley 


P10,T19 


uni top 


L^X 


pause 


Sy ,T2** 


score 


R2,T22 


use 


<;i 9 T9A 

OX ^ y X^H 


permit 


D5 


search 


C12,T6 


vbar 


pxH,Txy 


play 


PlOjTly 


searchf 


T6 


vec to L 


P7 Tl Q 


plot 


P5,T19 


seed 


C8 


vocab 


ta 
J** 


polar 


P12 


segment 


CI 


vocabs 


ta 
J**' 


pptaddr 


T25 


segmentf CI 


window 


P/ 


pptclr 


T25 


sendkey 


120 


write 


T) 1 Tl Q 

, PX ,TX-) 


pptdata 


T2o 


set 


C4,T4 


wTx tec 


Pi T 1 " 

rX y XX 3 


ppthalt 


T2/ 


setdat 


D2 


wrong 


T 1 lA Til 
JX|!)yTXX 


pptload 


T25 


setline 


F17 


wronga 


JXP 


pptout 


T2o 


setname 


F4,Fi5 


wrongc 


T 1 (A Tl r 
J X)l9)TX X 


ppt run 


T26 


setperm 


C8,T4 


wrongu 


JX2 


ppttest 


nno c 

T25 


show 


P2,T15 


wrongv 


Til Tl 0 

J XX ) xxz 


press 


Sll ,T23 


shova 


P3,T16 


xin 


T5 1 7 Tl 0 

PI / ,Txy 


put 


J5 


showb 


T15 


xml t 




putd 


J5,T10 


showe 


P2 


xout 


T3 1 7 Tl Q 

PX / ,Txy 


put V 


J J 


showh 


P3,T16 


zero 


PA TA 


randp 


C8,T5 


ShoVTO 


P3,T15 


* 


S17 


randu 


C8,T4 


showt 


P2,T15 


$$ 


S17 


rat 


P8,T19 


showz 


P2 


*fo rmat 


S20 


ratnm 


P8,T19 


site 


Ml 


*list 


S18 


rbox 


P8 


size 


P4,T16 


juitutor 


Ti 


rcircle 


P9,T19 


slide 


P16,T19 






rdot 


P8,T19 


sort 


C15 
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